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. DATETIME_ADD suporta 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 da semana 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 devolvidos

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 datas do modo de compatibilidade.

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