Función date_diff

Se aplica a: Databricks SQL Databricks Runtime 13.3 LTS y versiones posteriores

Esta función devuelve la diferencia entre dos marcas de tiempo medida en unidades unit. date_diff (marca de tiempo) es un sinónimo de la función timestampdiff.

Sintaxis

date_diff(unit, start, end)

unit
 { MICROSECOND |
   MILLISECOND |
   SECOND |
   MINUTE |
   HOUR |
   DAY |
   WEEK |
   MONTH |
   QUARTER |
   YEAR }

Argumentos

• unit: una unidad de medida.
• start: una expresión inicial de TIMESTAMP.
• end: una expresión final de TIMESTAMP.

Devoluciones

BIGINT.

Si start es mayor que end el resultado es negativo.

La función cuenta todas las unidades transcurridos en función de UTC con un DAY valor de 86400 segundos.

Se considera un mes transcurrido cuando el mes calendario aumentó y el día calendario y la hora son iguales o mayores al inicio. A partir de ahí se producen semanas, trimestres y años.

Ejemplos

-- 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

Funciones relacionadas

• add_months (función)
• función date_add (días)
• date_sub (función)
• datediff (función)
• timestamp (función)
• timestampadd (función)