DATETIME_SUB

Subtrai um intervalo de tempo especificado de uma data.

Exemplo de uso

DATETIME_SUB(Order Date, INTERVAL 1 WEEK)

Sintaxe

DATETIME_SUB( datetime_expression, INTERVAL integer part )

Parâmetros

  • datetime_expression: campo ou expressão de "Data" ou "Data e hora".
  • integer: campo numérico ou expressão inteira que representa o número de partes a serem subtraídas.
  • part: unidade de medida de tempo a ser subtraída. DATETIME_ADD aceita os seguintes valores de 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 no domingo.
    • ISOWEEK: usa limites da semana ISO 8601. As semanas ISO começam na segunda-feira.
    • MONTH
    • QUARTER
    • YEAR
    • ISOYEAR: usa o limite de ano com base na numeração da semana ISO 8601. O limite do ano ISO é a segunda-feira da primeira semana que contém a quinta-feira pertencente ao ano do calendário gregoriano correspondente.

Tipo de dados de retorno

Data e hora

Exemplos

Exemplo de fórmula Saída
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

Observações

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

Será necessário um tratamento especial para as partes MONTH, QUARTER e YEAR quando a data for o último dia do mês ou estiver perto dele. Se o mês resultante tiver menos dias do que os valores originais de "Data" e "Data e hora", o dia resultante será o último dia do mês novo.