Compartir a través de

Función timestampadd

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores

Esta función agrega unidades unit de valor value al elemento expr de una marca de tiempo.

Sintaxis

timestampadd(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 timestampadd(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 timestampadd(MONTH, -1, TIMESTAMP'2022-03-31 00:00:00');
 2022-02-28 00:00:00.000000