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
: uma expressão ou um campo "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 depart
: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
Example formula | Output |
---|---|
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
Esta 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.