TIMESTAMP soort

Van toepassing op:aangevinkt als ja Databricks SQL aangevinkt als ja Databricks Runtime

Vertegenwoordigt waarden die bestaan uit waarden van velden jaar, maand, dag, uur, minuut en seconde, met de lokale tijdzone van de sessie. De tijdstempelwaarde vertegenwoordigt een absoluut tijdstip.

Syntaxis

TIMESTAMP [ (p) ] | TIMESTAMP_LTZ [ (p) ]
  • p: Een optionele precisie van tot 6 , 9die het aantal fractieseconden van cijfers vertegenwoordigt. De standaardwaarde is 6. Specificeer 9 voor nanosecondenprecisie.

Important

TIMESTAMP(p) met precisie 7–9 is in Beta.

Limieten

Het bereik van ondersteunde tijdstempels is -290308-12-21 BCE 19:59:06 GMT aan +294247-01-10 CE 04:00:54 GMT.

Note

Wanneer men schrijft naar Delta of Parquet, TIMESTAMP(p) zijn waarden met precisie die groter dan 6 zijn beperkt tot de jaren 1677 tot en met 2262.

Letterlijke waarden

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]' }
  • + of -: een optioneel teken. - geeft BCE aan, + geeft CE (standaard) aan.
  • yyyy: Een jaar dat uit ten minste vier cijfers bestaat.
  • [m]m: Een maand van één of twee cijfers tussen 01 en 12.
  • [d]d: Een of twee cijferige dag tussen 01 en 31.
  • h[h]: Een of twee cijferig uur tussen 00 en 23.
  • m[m]: Een of twee cijferige minuut tussen 00 en 59.
  • s[s]: Een seconde van één of twee cijfers tussen 00 en 59.
  • [ms][ms][ms][us][us][us][ns][ns][ns]: Tot 9 cijfers van fractieseconden. Specificeer precies negen fractiecijfers om een TIMESTAMP(9) literal te construeren.

zoneId:

  • Z - Zulu tijdzone UTC+0
  • +|-[h]h:[m]m
  • Een ID met een van de voorvoegsels UTC+, UTC-, GMT+, GMT-, UT+ of UT-, en een achtervoegsel in de formaten:
    • +|-h[h]
    • +|-hh[:]mm
    • +|-hh:mm:ss
    • +|-hhmmss
  • Zone-id's op basis van regio's in de vorm <area>/<city>, Europe/Parisbijvoorbeeld.

Als de onderdelen van de maand of dag niet zijn opgegeven, worden ze standaard ingesteld op 1. Als er geen uur-, minuut- of tweede onderdelen worden opgegeven, worden ze standaard ingesteld op 0. Als er geen zoneId is opgegeven, wordt deze standaard ingesteld op sessietijdzone,

Als de letterlijke waarde geen juiste tijdstempel vertegenwoordigt, treedt er een fout op in Azure Databricks.

Opmerkingen

Tijdstempels met lokale tijdzone worden intern genormaliseerd en in UTC bewaard. Wanneer de waarde of een deel ervan wordt geëxtraheerd, wordt de lokale sessietijdzone toegepast.

Om kolommen in Delta Lake-tabellen te gebruiken TIMESTAMP(9) , schakel de functie tijdstempelprecisie in:

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

Het inschakelen van de functie verbetert het table-protocol. Clients die de functie niet ondersteunen kunnen de tabel niet lezen of schrijven. Bekijk de compatibiliteit en protocollen van Delta Lake-functies.

Voorbeelden

> 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) Tabelbeperkingen

  • Iceberg-tabellen worden niet ondersteund.
  • Gegenereerde kolommen in Delta Lake-tabellen worden niet ondersteund.
  • Kolommen voor vloeistofclustering in Delta Lake-tabellen worden niet ondersteund.
  • Laatst bijgewerkt om