Función make_timestamp

Se aplica a:casilla marcada como Sí Databricks SQL casilla marcada como Sí Databricks Runtime

Crea una marca de tiempo a partir de los campos year, month, day, hour, min, sec y timezone.

Sintaxis

make_timestamp(year, month, day, hour, min, sec [, timezone] )

make_timestamp(date [, time [, timezone]] )

Importante

El time argumento utiliza el TIME tipo de dato, que está en Beta.

Argumentos

  • year: Una expresión que INTEGER evalúa un valor de 1 a 9999.
  • month: Una INTEGER expresión que evalúa un valor del 1 (enero) al 12 (diciembre).
  • day: Una expresión que INTEGER evalúa un valor del 1 al 31.
  • hour: Una expresión que INTEGER evalúa un valor entre 0 y 23.
  • min: Una expresión que INTEGER evalúa un valor entre 0 y 59.
  • sec: expresión numérica con valor comprendido entre el 0 y el 60.
  • date: Una expresión que DATE proporciona el año, el mes y los campos de día.
  • time: Una expresión opcional TIME que proporciona los campos hora, minuto y segundo. El valor predeterminado es 00:00:00 si se omite.
  • timezone: Una expresión opcional STRING que evalúa a una zona horaria válida, como CET o UTC.

Devoluciones

Un objeto TIMESTAMP.

Si un argumento está fuera de límites, la función eleva DATETIME_FIELD_OUT_OF_BOUNDS. Usa try_make_timestamp para volver NULL en su lugar.

Si sec es 60, la función lo interpreta como 0 y añade un minuto al resultado.

Si sec tiene un valor fraccionario que no se puede representar en precisión de microsegundos, Azure Databricks genera INVALID_FRACTION_OF_SECOND.

Condiciones de error comunes

Ejemplos

> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887);
 2014-12-28 06:30:45.887
> SELECT make_timestamp(2014, 12, 28, 6, 30, 45.887, 'CET');
 2014-12-27 21:30:45.887
> SELECT make_timestamp(2019, 6, 30, 23, 59, 60);
 2019-07-01 00:00:00
> SELECT make_timestamp(NULL, 7, 22, 15, 30, 0);
 NULL

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887');
 2014-12-28 06:30:45.887

> SELECT make_timestamp(DATE'2014-12-28', TIME'06:30:45.887', 'CET');
 2014-12-27 21:30:45.887

> SELECT make_timestamp(DATE'2014-12-28');
 2014-12-28 00:00:00

> SELECT make_timestamp(2024, 13, 1, 0, 0, 0);
  Error: DATETIME_FIELD_OUT_OF_BOUNDS