Función date_add

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

Agrega value y unit al elemento expr de una marca de tiempo. Esta función es sinónimo de la función timestampadd.

Sintaxis

date_add(unit, value, expr)

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

Argumentos

• unit: una unidad de medida.
• value: expresión numérica con el número de unit que se van a agregar a expr.
• expr: expresión TIMESTAMP.

Devoluciones

Una expresión TIMESTAMP.

Si value es negativo, se resta de expr. Si unit es MONTH, QUARTER o YEAR, la parte del día del resultado se ajustará para dar como resultado una fecha válida.

La función devuelve un error de desbordamiento si el resultado está fuera del intervalo admitido de marcas de tiempo.

Ejemplos

> SELECT date_add(MICROSECOND, 5, TIMESTAMP'2022-02-28 00:00:00');
 2022-02-28 00:00:00.000005

-- March 31. 2022 minus 1 month yields February 28. 2022
> SELECT date_add(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000

Funciones relacionadas

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