TipoTIMESTAMP_NTZ

Aplica-se a: SQL do Databricks Databricks Runtime 13.3 LTS e superior

Representa valores que compõem valores de campos ano, mês, dia, hora, minuto e segundo. Todas as operações são executadas sem levar em conta nenhum fuso horário.

Esse recurso está em uma versão prévia. Confira a seção Anotações para ver os recursos sem suporte.

Para usar este recurso no Delta Lake, você deve habilitar o suporte para a tabela. O suporte a recursos é habilitado automaticamente quando você cria uma nova tabela Delta com uma coluna do tipo TIMESTAMP_NTZ. Ele não é habilitado automaticamente quando você adiciona uma coluna de tipo TIMESTAMP_NTZ a uma tabela existente. Para habilitar o suporte para colunas TIMESTAMP_NTZ, o suporte para o recurso deve estar explicitamente habilitado para a tabela existente.

Habilitar o suporte atualiza o protocolo de tabela. Consulte a compatibilidade de recursos e protocolos do Delta Lake. O comando a seguir habilita este recurso:

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

Sintaxe

TIMESTAMP [ (p) ] WITHOUT TIME ZONE | TIMESTAMP_NTZ [ (p) ]

TIMESTAMP WITHOUT TIME ZONE aplica-se ao Databricks Runtime 17.1 e superior.

• p: Uma precisão opcional de 6 até 9, representando o número de dígitos fracionários de segundo. O padrão é 6. Especifique 9 precisão em nanossegundos.

Limites

O intervalo de carimbos de data/hora com suporte é -290308-12-21 BCE 19:59:06 a +294247-01-10 CE 04:00:54.

Literais

TIMESTAMP_NTZ 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]' }

• + ou -: um sinal opcional. - indica a.C, + indica d.C (padrão).
• yyyy: um ano com no mínimo quatro dígitos.
• [m]m: um mês de um ou dois dígitos entre 01 e 12.
• [d]d: um dia de um ou dois dígitos entre 01 e 31.
• h[h]: uma hora de um ou dois dígitos entre 00 e 23.
• m[m]: um minuto de um ou dois dígitos entre 00 e 59.
• s[s]: um segundo de um ou dois dígitos entre 00 e 59.
• [ms][ms][ms][us][us][us][ns][ns][ns]: Até 9 dígitos de frações de segundo. Especifique exatamente nove dígitos fracionários para construir um TIMESTAMP_NTZ(9) literal.

Se os componentes mês ou dia não forem especificados, o padrão será 1. Se os componentes hora, minuto ou segundo não forem especificados, o padrão será 0.

Se o literal não representar um carimbo de data/hora adequado, o Azure Databricks gerará um erro.

Observações

TIMESTAMP_NTZ tem as seguintes limitações:

• O suporte ao Photon requer o Databricks SQL ou o Databricks Runtime 15.4 e superior.
• Não há suporte no OpenSharing no Databricks Runtime 14.0 e abaixo.
• O tipo TIMESTAMP_NTZ tem suporte em fontes de arquivo, incluindo Delta/Parquet/ORC/AVRO/JSON/CSV. No entanto, há uma limitação na inferência de esquema para arquivos JSON/CSV com colunas TIMESTAMP_NTZ. Para compatibilidade com versões anteriores, o tipo de carimbo de data/hora inferido padrão de spark.read.csv(...) ou spark.read.json(...) será o tipo TIMESTAMP em vez de TIMESTAMP_NTZ.

Para usar TIMESTAMP_NTZ(9) colunas em uma tabela Delta Lake existente, ative tanto as timestampNtz características e timestampPrecision quanto:

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

Exemplos

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

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

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

> SELECT current_timezone(), CAST(TIMESTAMP '2021-7-1T8:43:28' as TIMESTAMP_NTZ);
  America/Los_Angeles 2021-07-01 08:43:28

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

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

> SELECT '1908-03-15 10:1:17'::TIMESTAMP WITHOUT TIME ZONE)
  1908-03-15 10:01:17

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

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

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

TIMESTAMP_NTZ(9) Limitações da tabela

• Tabelas de iceberg não são suportadas.
• Colunas geradas em tabelas Delta Lake não são suportadas.
• Colunas de agrupamento líquido nas mesas Delta Lake não são suportadas.

Relacionados

• TIMESTAMP tipo
• DATE tipo
• INTERVAL tipo
• cast função