Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Função
Aplica-se a:
SQL do Databricks
Databricks Runtime 13.3 LTS e superior
Retorna a diferença entre duas datas em dias, ou entre dois carimbos de tempo em uma unidade especificada.
Sintaxe
date_diff(endDate, startDate)
date_diff(unit, start, end)
unit
{ MICROSECOND |
MILLISECOND |
SECOND |
MINUTE |
HOUR |
DAY |
WEEK |
MONTH |
QUARTER |
YEAR }
Argumentos
-
endDate: Uma expressãoDATEfinal. -
startDate: Uma expressãoDATEinicial. -
unit: uma unidade de medida. -
start: Uma expressãoTIMESTAMPinicial. -
end: Uma expressãoTIMESTAMPfinal.
Retornos
- Para
date_diff(endDate, startDate), eINTEGERque representa o número de dias destartDateatéendDate. - Para
date_diff(unit, start, end), aBIGINTque representa a diferença entrestarteendmedida emunits. Essa forma é sinônimo detimestampdifffunção.
O resultado é negativo se o valor inicial for maior que o valor final.
A função conta unidades decorridas inteiras com base em UTC e um DAY de 86400 segundos.
Um mês é considerado decorrido quando o mês do calendário aumentou e o dia e o horário do calendário são iguais ou maiores para o início. Semanas, trimestres e anos acompanham isso.
Exemplos
> SELECT date_diff(DATE'2009-07-31', DATE'2009-07-30');
1
-- One second shy of a month elapsed
> SELECT date_diff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 11:59:59');
0
-- One month has passed even though its' not end of the month yet because day and time line up.
> SELECT date_diff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 12:00:00');
1
-- Start is greater than the end
> SELECT date_diff(YEAR, DATE'2021-01-01', DATE'1900-03-28');
-120