Zeitstempel mit Zeitzone-Funktionen

Dieser Abschnitt beschreibt Funktionen und Operatoren zum Untersuchen und Manipulieren von TIMESTAMP WITH TIME ZONE (oder TIMESTAMPTZ)-Werten. Siehe auch die verwandten TIMESTAMP-Funktionen.

Die Zeitzonenunterstützung wird von der eingebauten ICU-Erweiterung bereitgestellt.

In den Beispielen unten wird angenommen, dass die aktuelle Zeitzone America/Los_Angeles mit dem gregorianischen Kalender ist.

Eingebaute Zeitstempel-mit-Zeitzone-Funktionen

Die folgende Tabelle zeigt die verfügbaren skalaren Funktionen für TIMESTAMPTZ-Werte. Da diese Funktionen weder Binning noch Anzeige betreffen, sind sie immer verfügbar.

Name	Beschreibung
`current_timestamp`	Aktuelles Datum und Uhrzeit (Beginn der aktuellen Transaktion).
`get_current_timestamp()`	Aktuelles Datum und Uhrzeit (Beginn der aktuellen Transaktion).
`greatest(timestamptz, timestamptz)`	Der spätere der beiden Zeitstempel.
`isfinite(timestamptz)`	Gibt true zurück, wenn der Zeitstempel mit Zeitzone endlich ist, sonst false.
`isinf(timestamptz)`	Gibt true zurück, wenn der Zeitstempel mit Zeitzone unendlich ist, sonst false.
`least(timestamptz, timestamptz)`	Der frühere der beiden Zeitstempel.
`now()`	Aktuelles Datum und Uhrzeit (Beginn der aktuellen Transaktion).
`timetz_byte_comparable(timetz)`	Wandelt ein `TIME WITH TIME ZONE` in einen `UBIGINT`-Sortierschlüssel um.
`to_timestamp(double)`	Wandelt Sekunden seit der Epoche in einen Zeitstempel mit Zeitzone um.
`transaction_timestamp()`	Aktuelles Datum und Uhrzeit (Beginn der aktuellen Transaktion).

`current_timestamp`

`get_current_timestamp()`

`greatest(timestamptz, timestamptz)`

`isfinite(timestamptz)`

`isinf(timestamptz)`

`least(timestamptz, timestamptz)`

`now()`

`timetz_byte_comparable(timetz)`

`to_timestamp(double)`

`transaction_timestamp()`

Zeichenketten für Zeitstempel mit Zeitzone

Ohne geladene Zeitzonen-Erweiterung werden TIMESTAMPTZ-Werte mit Offset-Notation in Zeichenketten und aus Zeichenketten umgewandelt. So können Sie einen Zeitpunkt korrekt angeben, ohne Zugriff auf Zeitzoneninformationen. Der Portabilität wegen werden TIMESTAMPTZ-Werte immer mit GMT-Offsets angezeigt:

SELECT '2022-10-08 13:13:34-07'::TIMESTAMPTZ;

2022-10-08 20:13:34+00

Ist eine Zeitzonen-Erweiterung wie ICU geladen, kann eine Zeitzone aus einer Zeichenkette geparst und in eine Darstellung in der lokalen Zeitzone umgewandelt werden:

SELECT '2022-10-08 13:13:34 Europe/Amsterdam'::TIMESTAMPTZ::VARCHAR;

2022-10-08 04:13:34-07 -- the offset will differ based on your local time zone

ICU-Operatoren für Zeitstempel mit Zeitzone

Die folgende Tabelle zeigt die verfügbaren mathematischen Operatoren für TIMESTAMP WITH TIME ZONE-Werte, die die ICU-Erweiterung bereitstellt.

Operator	Beschreibung	Beispiel	Ergebnis
`+`	Addition eines `INTERVAL`	`TIMESTAMPTZ '1992-03-22 01:02:03' + INTERVAL 5 DAY`	`1992-03-27 01:02:03`
`-`	Subtraktion von `TIMESTAMPTZ`s	`TIMESTAMPTZ '1992-03-27' - TIMESTAMPTZ '1992-03-22'`	`5 days`
`-`	Subtraktion eines `INTERVAL`	`TIMESTAMPTZ '1992-03-27 01:02:03' - INTERVAL 5 DAY`	`1992-03-22 01:02:03`

Addition zu oder Subtraktion von unendlichen Werten liefert denselben unendlichen Wert.

Addition und Subtraktion von Intervallen verwendet die ICU-Calendar-add-Funktion. Bei positiven Intervallen (vorwärts in der Zeit) werden die Felder vom wenigsten zum bedeutendsten erhöht. Bei negativen Intervallen (rückwärts in der Zeit) werden die Felder vom bedeutendsten zum wenigsten verringert. Das liefert dieselben Ergebnisse wie Postgres, entspricht aber nicht einigen neueren Kalender-RFCs.

ICU-Funktionen für Zeitstempel mit Zeitzone

Die folgende Tabelle zeigt die von ICU bereitgestellten skalaren Funktionen für TIMESTAMP WITH TIME ZONE-Werte.

Name	Beschreibung
`age(timestamptz, timestamptz)`	Subtrahiert die Argumente und liefert die Zeitdifferenz zwischen den beiden Zeitstempeln.
`age(timestamptz)`	Subtrahiert vom current_date.
`date_diff(part, starttimestamptz, endtimestamptz)`	Die Anzahl der `part`-Grenzen zwischen `starttimestamptz` und `endtimestamptz`, einschließlich des größeren und ausschließlich des kleineren Zeitstempels.
`date_part([part, ...], timestamp)`	Holt die aufgeführten Teilfelder als `struct`. Die Liste muss konstant sein.
`date_part(part, timestamp)`	Teilfeld holen (entspricht `extract`).
`date_sub(part, starttimestamptz, endtimestamptz)`	Die vorzeichenbehaftete Länge des Intervalls zwischen `starttimestamptz` und `endtimestamptz`, auf ganze Vielfache von `part` gekürzt.
`date_trunc(part, timestamptz)`	Auf die angegebene Genauigkeit kürzen.
`epoch_ns(timestamptz)`	Wandelt einen timestamptz in Nanosekunden seit der Epoche um.
`epoch_us(timestamptz)`	Wandelt einen timestamptz in Mikrosekunden seit der Epoche um.
`extract(field FROM timestamptz)`	Teilfeld aus einem `TIMESTAMP WITH TIME ZONE` holen.
`last_day(timestamptz)`	Der letzte Tag des Monats.
`make_timestamptz(bigint, bigint, bigint, bigint, bigint, double, string)`	Der `TIMESTAMP WITH TIME ZONE` für die angegebenen Teile und die Zeitzone.
`make_timestamptz(bigint, bigint, bigint, bigint, bigint, double)`	Der `TIMESTAMP WITH TIME ZONE` für die angegebenen Teile in der aktuellen Zeitzone.
`make_timestamptz(microseconds)`	Der `TIMESTAMP WITH TIME ZONE` für die angegebenen µs seit der Epoche.
`strftime(timestamptz, format)`	Wandelt einen `TIMESTAMP WITH TIME ZONE`-Wert gemäß dem Formatstring in eine Zeichenkette um.
`strptime(text, format)`	Wandelt eine Zeichenkette gemäß dem Formatstring in `TIMESTAMP WITH TIME ZONE` um, wenn `%Z` angegeben ist.
`time_bucket(bucket_width, timestamptz[, offset])`	Kürzt `timestamptz` auf ein Raster der Breite `bucket_width`. Das Raster ist bei `2000-01-01 00:00:00+00:00[ + offset]` verankert, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst bei `2000-01-03 00:00:00+00:00[ + offset]`. Beachten Sie, dass `2000-01-03` ein Montag ist.
`time_bucket(bucket_width, timestamptz[, origin])`	Kürzt `timestamptz` auf ein Raster der Breite `bucket_width`. Das Raster ist am Zeitstempel `origin` verankert, der standardmäßig `2000-01-01 00:00:00+00:00` ist, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst `2000-01-03 00:00:00+00:00`. Beachten Sie, dass `2000-01-03` ein Montag ist.
`time_bucket(bucket_width, timestamptz[, timezone])`	Kürzt `timestamptz` auf ein Raster der Breite `bucket_width`. Das Raster ist am Zeitstempel `origin` verankert, der standardmäßig `2000-01-01 00:00:00` in der angegebenen `timezone` ist, wenn `bucket_width` eine Anzahl von Monaten oder gröberen Einheiten ist, sonst `2000-01-03 00:00:00` in der angegebenen `timezone`. Die Standardzeitzone ist `'UTC'`. Beachten Sie, dass `2000-01-03` ein Montag ist.

`age(timestamptz, timestamptz)`

`age(timestamptz)`

`date_diff(part, starttimestamptz, endtimestamptz)`

| Beschreibung | Die vorzeichenbehaftete Anzahl der part-Grenzen zwischen starttimestamptz und endtimestamptz, einschließlich des größeren und ausschließlich des kleineren Zeitstempels. | | Beispiel | date_diff('hour', TIMESTAMPTZ '1992-09-30 23:59:59', TIMESTAMPTZ '1992-10-01 01:58:00') | | Ergebnis | 2 |

`date_part([part, ...], timestamptz)`

| Beschreibung | Holt die aufgeführten Teilfelder als struct. Die Liste muss konstant sein. | | Beispiel | date_part(['year', 'month', 'day'], TIMESTAMPTZ '1992-09-20 20:38:40-07') | | Ergebnis | {year: 1992, month: 9, day: 20} |

`date_part(part, timestamptz)`

`date_sub(part, starttimestamptz, endtimestamptz)`

| Beschreibung | Die vorzeichenbehaftete Länge des Intervalls zwischen starttimestamptz und endtimestamptz, auf ganze Vielfache von part gekürzt. | | Beispiel | date_sub('hour', TIMESTAMPTZ '1992-09-30 23:59:59', TIMESTAMPTZ '1992-10-01 01:58:00') | | Ergebnis | 1 |

`date_trunc(part, timestamptz)`

`epoch_ns(timestamptz)`

`epoch_us(timestamptz)`

`extract(field FROM timestamptz)`

`last_day(timestamptz)`

`make_timestamptz(bigint, bigint, bigint, bigint, bigint, double, string)`

`make_timestamptz(bigint, bigint, bigint, bigint, bigint, double)`

`make_timestamptz(microseconds)`

`strftime(timestamptz, format)`

`strptime(text, format)`

| Beschreibung | Wandelt eine Zeichenkette gemäß dem Formatstring in TIMESTAMP WITH TIME ZONE um, wenn %Z angegeben ist. | | Beispiel | strptime('Wed, 1 January 1992 - 08:38:40 PST', '%a, %-d %B %Y - %H:%M:%S %Z') | | Ergebnis | 1992-01-01 08:38:40-08 |

`time_bucket(bucket_width, timestamptz[, offset])`

| Beschreibung | Kürzt timestamptz auf ein Raster der Breite bucket_width. Das Raster ist bei 2000-01-01 00:00:00+00:00[ + offset] verankert, wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst bei 2000-01-03 00:00:00+00:00[ + offset]. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '10 minutes', TIMESTAMPTZ '1992-04-20 15:26:00-07', INTERVAL '5 minutes') | | Ergebnis | 1992-04-20 15:25:00-07 |

`time_bucket(bucket_width, timestamptz[, origin])`

| Beschreibung | Kürzt timestamptz auf ein Raster der Breite bucket_width. Das Raster ist am Zeitstempel origin verankert, der standardmäßig 2000-01-01 00:00:00+00:00 ist, wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst 2000-01-03 00:00:00+00:00. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '2 weeks', TIMESTAMPTZ '1992-04-20 15:26:00-07', TIMESTAMPTZ '1992-04-01 00:00:00-07') | | Ergebnis | 1992-04-15 00:00:00-07 |

`time_bucket(bucket_width, timestamptz[, timezone])`

| Beschreibung | Kürzt timestamptz auf ein Raster der Breite bucket_width. Das Raster ist am Zeitstempel origin verankert, der standardmäßig 2000-01-01 00:00:00 in der angegebenen timezone ist, wenn bucket_width eine Anzahl von Monaten oder gröberen Einheiten ist, sonst 2000-01-03 00:00:00 in der angegebenen timezone. Die Standardzeitzone ist 'UTC'. Beachten Sie, dass 2000-01-03 ein Montag ist. | | Beispiel | time_bucket(INTERVAL '2 days', TIMESTAMPTZ '1992-04-20 15:26:00-07', 'Europe/Berlin') | | Ergebnis | 1992-04-19 15:00:00-07 (=1992-04-20 00:00:00 Europe/Berlin) |

Es gibt außerdem eigene Extraktionsfunktionen für die Teilfelder.

ICU-Zeitstempel-Tabellenfunktionen

Die folgende Tabelle zeigt die verfügbaren Tabellenfunktionen für den Typ TIMESTAMP WITH TIME ZONE.

Name	Beschreibung
`generate_series(timestamptz, timestamptz, interval)`	Erzeugt eine Tabelle von Zeitstempeln im geschlossenen Bereich (einschließlich Start- und Endzeitstempel), in Schritten des Intervalls.
`range(timestamptz, timestamptz, interval)`	Erzeugt eine Tabelle von Zeitstempeln im halboffenen Bereich (einschließlich Startzeitstempel, aber vor dem Endzeitstempel stoppend), in Schritten des Intervalls.

Unendliche Werte sind als Grenzen von Tabellenfunktionen nicht erlaubt.

`generate_series(timestamptz, timestamptz, interval)`

| Beschreibung | Erzeugt eine Tabelle von Zeitstempeln im geschlossenen Bereich (einschließlich Start- und Endzeitstempel), in Schritten des Intervalls. | | Beispiel | generate_series(TIMESTAMPTZ '2001-04-10', TIMESTAMPTZ '2001-04-11', INTERVAL 30 MINUTE) |

`range(timestamptz, timestamptz, interval)`

| Beschreibung | Erzeugt eine Tabelle von Zeitstempeln im halboffenen Bereich (einschließlich Startzeitstempel, aber vor dem Endzeitstempel stoppend), in Schritten des Intervalls. | | Beispiel | range(TIMESTAMPTZ '2001-04-10', TIMESTAMPTZ '2001-04-11', INTERVAL 30 MINUTE) |

ICU-Funktionen für Zeitstempel ohne Zeitzone

Die folgende Tabelle zeigt die von ICU bereitgestellten skalaren Funktionen, die auf gewöhnlichen TIMESTAMP-Werten arbeiten. Diese Funktionen gehen davon aus, dass der TIMESTAMP ein „lokaler Zeitstempel“ ist.

Ein lokaler Zeitstempel ist im Wesentlichen eine Möglichkeit, die Teilwerte aus einer Zeitzone in einem einzelnen Wert zu kodieren. Sie sollten mit Vorsicht verwendet werden, weil die erzeugten Werte durch die Sommerzeit Lücken und Mehrdeutigkeiten enthalten können. Oft lässt sich dieselbe Funktionalität zuverlässiger mit der struct-Variante der Funktion date_part umsetzen.

Name	Beschreibung
`current_localtime()`	Gibt ein `TIME` zurück, dessen GMT-Bin-Werte der lokalen Uhrzeit in der aktuellen Zeitzone entsprechen.
`current_localtimestamp()`	Gibt ein `TIMESTAMP` zurück, dessen GMT-Bin-Werte dem lokalen Datum und der lokalen Uhrzeit in der aktuellen Zeitzone entsprechen.
`localtime`	Synonym für den Funktionsaufruf `current_localtime()`.
`localtimestamp`	Synonym für den Funktionsaufruf `current_localtimestamp()`.
`timezone(text, timestamp)`	Verwendet die Datumsteile des Zeitstempels in GMT, um einen Zeitstempel in der angegebenen Zeitzone zu konstruieren. Das Argument ist faktisch eine „lokale“ Zeit.
`timezone(text, timestamptz)`	Verwendet die Datumsteile des Zeitstempels in der angegebenen Zeitzone, um einen Zeitstempel zu konstruieren. Das Ergebnis ist faktisch eine „lokale“ Zeit.

`current_localtime()`

`current_localtimestamp()`

`localtime`

`localtimestamp`

`timezone(text, timestamp)`

| Beschreibung | Verwendet die Datumsteile des Zeitstempels in GMT, um einen Zeitstempel in der angegebenen Zeitzone zu konstruieren. Das Argument ist faktisch eine „lokale“ Zeit. | | Beispiel | timezone('America/Denver', TIMESTAMP '2001-02-16 20:38:40') | | Ergebnis | 2001-02-16 19:38:40-08 |

`timezone(text, timestamptz)`

| Beschreibung | Verwendet die Datumsteile des Zeitstempels in der angegebenen Zeitzone, um einen Zeitstempel zu konstruieren. Das Ergebnis ist faktisch eine „lokale“ Zeit. | | Beispiel | timezone('America/Denver', TIMESTAMPTZ '2001-02-16 20:38:40-05') | | Ergebnis | 2001-02-16 18:38:40 |

At Time Zone

Die Syntax AT TIME ZONE ist syntaktischer Zucker für die oben aufgeführte (zweiargumentige) Funktion timezone:

SELECT TIMESTAMP '2001-02-16 20:38:40' AT TIME ZONE 'America/Denver' AS ts;

2001-02-16 19:38:40-08

SELECT TIMESTAMP WITH TIME ZONE '2001-02-16 20:38:40-05' AT TIME ZONE 'America/Denver' AS ts;

2001-02-16 18:38:40

Beachten Sie, dass numerische Zeitzonen nicht erlaubt sind:

SELECT TIMESTAMP '2001-02-16 20:38:40-05' AT TIME ZONE '0200' AS ts;

Not implemented Error: Unknown TimeZone '0200'

Unendlichkeiten

Auf unendliche Daten angewendete Funktionen geben entweder dieselben unendlichen Daten zurück (z. B. greatest) oder NULL (z. B. date_part), je nachdem, was „Sinn ergibt“. Muss die Funktion die Teile des unendlichen temporalen Werts untersuchen, ist das Ergebnis in der Regel NULL.

Kalender

Die ICU-Erweiterung unterstützt außerdem nicht-gregorianische Kalender. Ist ein solcher Kalender aktuell, verwenden Anzeige- und Binning-Operationen diesen Kalender.

Sommerzeitübergänge (DST)

Beim Addieren von Kalenderintervallen wie INTERVAL '1 day' zu einem TIMESTAMPTZ kann der resultierende lokale Zeitstempel auf eine nicht existierende Zeit während der Sommerzeitübergänge fallen.

DuckDB folgt dem Verhalten von PostgreSQL und verschiebt das Ergebnis vorwärts auf den nächsten gültigen Zeitstempel.

Beispiel:

SET timezone = 'Europe/Amsterdam';

SELECT TIMESTAMPTZ '2025-03-29 02:30:00+01' + INTERVAL '1 day';

2025-03-30 03:30:00+02