DATETIME_SUB

Subtrai um intervalo de tempo específico de uma data.

Exemplos de utilização

DATETIME_SUB(Order Date, INTERVAL 1 WEEK)

Sintaxe

DATETIME_SUB( datetime_expression, INTERVAL integer part )

Parâmetros

  • datetime_expression - um campo ou uma expressão de data ou de data e hora.
  • integer - um campo ou uma expressão numérica inteira que representa o número de partes a subtrair.
  • part - a unidade de medida de tempo a subtrair. A função DATETIME_ADD é compatível com os seguintes valores para part:
    • MICROSECOND: disponível para campos ou expressões de data e hora.
    • MILLISECOND: disponível para campos ou expressões de data e hora.
    • SECOND: disponível para campos ou expressões de data e hora.
    • MINUTE: disponível para campos ou expressões de data e hora.
    • HOUR: disponível para campos ou expressões de data e hora.
    • DAY
    • WEEK: esta parte da data começa ao domingo.
    • ISOWEEK: usa os limites de semana da norma ISO 8601. As semanas ISO começam à segunda-feira.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: usa o limite do ano de numeração de semanas da norma ISO 8601. O limite do ano ISO é a segunda-feira da primeira semana cuja quinta-feira pertence ao ano civil gregoriano correspondente.

Tipo de dados devolvido

Data e hora

Exemplos

Fórmula de exemplo Resultado
DATETIME_SUB(DATETIME "2008-12-25 15:30:00", INTERVAL 10 MINUTE) 2008-12-25 15:20:00
DATETIME_SUB(DATE "2008-12-25", INTERVAL 5 DAY) 2008-12-20

Notas

Esta função não está disponível para tipos de dados de data do modo de compatibilidade.

É necessário um tratamento especial para as partes MONTH, QUARTER e YEAR quando a data está no (ou perto do) último dia do mês. Se o mês resultante tiver menos dias do que o dia da data ou da data e hora original, o dia do resultado é o último dia do novo mês.