Tipo deTIMESTAMP

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

Representa valores que de campos de año, mes, día, hora, minuto y segundo, con la zona horaria local de la sesión. El valor de marca de tiempo representa un punto absoluto en el tiempo.

Sintaxis

TIMESTAMP [ (p) ] | TIMESTAMP_LTZ [ (p) ]
  • p: Una precisión opcional de 6 hasta 9, que representa el número de dígitos de fracción de segundo. El valor predeterminado es 6. Especifica 9 para precisión en nanosegundos.

Importante

TIMESTAMP(p) con precisión 7–9 está en Beta.

Límites

El intervalo de marca de tiempo admitido es de -290308-12-21 BCE 19:59:06 GMT a +294247-01-10 CE 04:00:54 GMT.

Note

Al escribir a Delta o Parquet, valores TIMESTAMP(p) con mayor 6 precisión están limitados a los años 1677 a 2262.

Literales

TIMESTAMP timestampString

TIMESTAMP_LTZ timestampString

timestampString
{ '[+|-]yyyy[...]' |
  '[+|-]yyyy[...]-[m]m' |
  '[+|-]yyyy[...]-[m]m-[d]d' |
  '[+|-]yyyy[...]-[m]m-[d]d ' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h[:]' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m[:]' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m:[s]s[.]' |
  '[+|-]yyyy[...]-[m]m-[d]d[T][h]h:[m]m:[s]s.[ms][ms][ms][us][us][us][ns][ns][ns][zoneId]' }
  • + o -: un signo opcional. - indica BCE, + indica CE (valor predeterminado).
  • yyyy: un año que comprende al menos cuatro dígitos.
  • [m]m: mes de uno o dos dígitos entre 01 y 12.
  • [d]d: día de uno o dos dígitos entre 01 y 31.
  • h[h]: día de uno o dos dígitos entre 00 y 23.
  • m[m]: minuto de uno o dos dígitos entre 00 y 59.
  • s[s]: un segundo de uno o dos dígitos entre 00 y 59.
  • [ms][ms][ms][us][us][us][ns][ns][ns]: Hasta 9 dígitos de fracciones de segundo. Especifica exactamente nueve dígitos fraccionarios para construir un TIMESTAMP(9) literal.

zoneId:

  • Z - zona horaria Zulú UTC+0
  • +|-[h]h:[m]m
  • Un identificador con uno de los prefijos UTC+, UTC-, GMT+, GMT-, UT+ o UT-, y un sufijo en los formatos:
    • +|-h[h]
    • +|-hh[:]mm
    • +|-hh:mm:ss
    • +|-hhmmss
  • Los identificadores de zona basados en regiones con el formulario <area>/<city>, por ejemplo, Europe/Paris.

Si no se especifican los componentes de mes o día, el valor predeterminado es 1. Si no se especifican componentes de hora, minuto o segundo, el valor predeterminado es 0. Si no se especifica zoneId, se utiliza la zona horaria de sesión como valor predeterminado.

Si el literal no representa una marca de tiempo adecuada de Azure Databricks genera un error.

Notas

Las marcas de tiempo con zona horaria local se normalizan internamente y se conservan en UTC. Cada vez que se extrae el valor o una parte de él, se aplica la zona horaria de la sesión local.

Para usar TIMESTAMP(9) columnas en las tablas de Delta Lake, active la función de precisión con marca temporal:

ALTER TABLE table_name SET TBLPROPERTIES ('delta.feature.timestampPrecision' = 'supported')

Activar esta función mejora el protocolo de tabla. Los clientes que no soportan la función no pueden leer ni escribir la tabla. Consulte Compatibilidad y protocolos de características de Delta Lake.

Ejemplos

> SELECT TIMESTAMP'0000';
  0000-01-01 00:00:00

> SELECT TIMESTAMP'2020-12-31';
  2020-12-31 00:00:00

> SELECT TIMESTAMP'2021-7-1T8:43:28.123456';
  2021-07-01 08:43:28.123456

> SELECT current_timezone(), TIMESTAMP'2021-7-1T8:43:28UTC+3';
  America/Los_Angeles 2021-06-30 22:43:28

> SELECT CAST('1908-03-15 10:1:17' AS TIMESTAMP)
  1908-03-15 10:01:17

> SELECT TIMESTAMP'+10000';
  +10000-01-01 00:00:00

> SELECT typeof(TIMESTAMP'2026-08-18 14:30:45.123456789');
  TIMESTAMP(9)

> SELECT CAST('2026-08-18 14:30:45.123456789' AS TIMESTAMP(9));
  2026-08-18 14:30:45.123456789

TIMESTAMP(9) Limitaciones de la tabla

  • No se soportan mesas iceberg.
  • No se admiten columnas generadas en tablas Delta Lake.
  • No se soportan columnas de agrupación líquida en las mesas Delta Lake.
  • Se actualizó por última vez el