Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Função
Aplica-se a:
Databricks SQL
Databricks Runtime 10.4 LTS e superior
Devolve a diferença entre dois carimbos de data/hora medidos em units.
Sintaxe
timestampdiff(unit, start, end)
unit
{ MICROSECOND |
MILLISECOND |
SECOND |
MINUTE |
HOUR |
DAY |
WEEK |
MONTH |
QUARTER |
YEAR }
Argumentos
-
unit: Uma unidade de medida. -
start: Uma expressão inicialTIMESTAMP. -
end: Uma expressão finalTIMESTAMP.
Devoluções
Um BIGINT.
Se start for maior que end o resultado é negativo.
A função conta unidades inteiras decorridas com base em UTC um DAY ser 86400 segundos.
Considera-se decorrido um mês quando o mês civil tiver aumentado e o dia e a hora do calendário forem iguais ou superiores ao início. Seguem-se semanas, trimestres e anos.
Exemplos
-- One second shy of a month elapsed
> SELECT timestampdiff(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 timestampdiff(MONTH, TIMESTAMP'2021-02-28 12:00:00', TIMESTAMP'2021-03-28 12:00:00');
1
-- Start is greater than the end
> SELECT timestampdiff(YEAR, DATE'2021-01-01', DATE'1900-03-28');
-120