View a markdown version of this page

Funktion CONVERT_TIMEZONE - Amazon Redshift

Amazon Redshift unterstützt die Verwendung von Python-UDFs nach dem 30. Juni 2026 nicht mehr. Wir werden damit beginnen, es schrittweise durchzusetzen. Weitere Informationen zu den Details zum Ende der Lebensdauer von Python und zu den Migrationsoptionen finden Sie auf der Blogbeitrag das wurde am 30. Juni 2025 veröffentlicht.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Funktion CONVERT_TIMEZONE

CONVERT_TIMEZONE konvertiert einen Zeitstempel von einer Zeitzone zu einer anderen. Die Funktion passt sich automatisch an die Sommerzeit an.

Syntax

CONVERT_TIMEZONE( ['source_timezone',] 'target_timezone', 'timestamp')

Argumente

source_timezone

(Optional) Die Zeitzone des aktuellen Zeitstempels. Der Standardwert ist UTC. Weitere Informationen finden Sie unter Nutzungshinweise zu Zeitstempeln.

target_timezone

Die Zeitzone für den neuen Zeitstempel. Weitere Informationen finden Sie unter Nutzungshinweise zu Zeitstempeln.

timestamp

Eine Zeitstempelspalte bzw. ein entsprechender Ausdruck, die/der implizit zu einem Zeitstempel konvertiert wird.

Rückgabetyp

TIMESTAMP

Nutzungshinweise zu Zeitstempeln

source_timezone oder target_timezone kann als Zeitzonenname angegeben werden (z. B. 'Africa/Kampala'oder' Singapur ') oder als Zeitzonenabkürzung (wie' UTC 'oder' PDT '). Sie müssen Zeitzonennamen nicht in Namen oder Abkürzungen in Abkürzungen konvertieren. Sie können beispielsweise einen Zeitstempel aus dem Quellzeitzonennamen „Singapur“ auswählen und ihn in einen Zeitstempel in der Zeitzonenabkürzung „PDT“ konvertieren.

Anmerkung

Die Ergebnisse bei der Verwendung eines Zeitzonennamens oder einer Zeitzonenabkürzung können aufgrund lokaler saisonaler Zeit, wie z. B. Sommerzeit, unterschiedlich sein.

Verwendung eines Zeitzonennamens

Eine aktuelle und vollständige Liste der Zeitzonennamen erhalten Sie, wenn Sie den folgenden Befehl ausführen.

select pg_timezone_names();

Jede Zeile enthält eine durch Kommas getrennte Zeichenfolge mit dem Namen der Zeitzone, der Zeitzonenabkürzung, dem UTC-Offset (Coordinated Universal Time) und einem Indikator dafür, ob in der Zeitzone derzeit Sommerzeit herrscht (t oder f). Die Abkürzung, der Offset und der Indikator werden für das aktuelle Datum und die aktuelle Uhrzeit berechnet. Sie können sich also ändern, je nachdem, wann Sie den Befehl ausführen. Der folgende Ausschnitt zeigt beispielsweise zwei Zeilen, die aus einer Befehlsausführung im Januar resultieren. Die erste Zeile ist die Zeitzone Antarctica/South_Pole, Abkürzung NZDT, mit einem 13:00:00 Offset von UTC und t um anzuzeigen, dass derzeit Sommerzeit herrscht. Die zweite Zeile ist die Zeitzone Europe/Paris, Abkürzung CET, mit einem 01:00:00 Offset von UTC und f um anzuzeigen, dass derzeit keine Sommerzeit herrscht. Wenn Sie denselben Befehl im Juli ausführen, Europe/Paris kehrt zurück CEST, 02:00:00, und t.

pg_timezone_names ------------------ (Antarctica/South_Pole,NZDT,13:00:00,t) (Europe/Paris,CET,01:00:00,f)

Führen Sie die SQL-Anweisung aus, um die gesamte Liste abzurufen und einen Zeitzonennamen zu finden. Es werden ungefähr 600 Zeilen zurückgegeben. Auch wenn es sich bei einigen der zurückgegebenen Zeitzonennamen um Akronyme handelt (etwa GB, PRC, ROK), werden sie von der Funktion CONVERT_TIMEZONE als Zeitzonennamen und nicht als Zeitzonenabkürzungen behandelt.

Wenn Sie eine Zeitzone mit einem Zeitzonennamen angeben, nimmt CONVERT_TIMEZONE automatisch Anpassungen für die Sommerzeit oder andere lokale saisonale Protokolle wie beispielsweise Standardzeit oder Winterzeit vor, die für die betreffende Zeitzone während des von „timestamp“ angegebenen Datums bzw. der Uhrzeit gelten. Zum Beispiel 'Europe/London'steht für UTC im Winter und fügt im Sommer eine Stunde hinzu. Beachten Sie, dass Amazon Redshift die IANA-Zeitzonendatenbank als maßgebliche Quelle für die Zeitzonenspezifikation verwendet.

Verwendung einer Zeitzonenabkürzung

Führen Sie für eine vollständige Liste der Zeitzonenabkürzungen den folgenden Befehl aus.

select pg_timezone_abbrevs();

Die Ergebnisse enthalten eine durch Kommata getrennte Zeichenfolge mit der Abkürzung der Zeitzone, dem UTC-Offset und der Angabe, ob in der Zeitzone die Sommerzeit gilt (t oder f). Das folgende Snippet zeigt beispielsweise zwei Ergebniszeilen. Die erste Zeile enthält die Abkürzung für Pacific Daylight Time PDT mit einem UTC-Offset von -07:00:00 sowie die Angabe t, um anzuzeigen, dass die Sommerzeit gilt. Die zweite Zeile enthält die Abkürzung für Pacific Daylight Time PST mit einem UTC-Offset von -08:00:00 sowie die Angabe f, um anzuzeigen, dass die Sommerzeit nicht gilt.

pg_timezone_abbrevs -------------------- (PDT,-07:00:00,t) (PST,-08:00:00,f)

Führen Sie die SQL-Anweisung aus, um die gesamte Liste abzurufen und anhand des Offsets und der Angabe zur Sommerzeit nach einer Abkürzung zu suchen. Es werden ungefähr 200 Zeilen zurückgegeben.

Zeitzonenabkürzungen stehen für eine feste Verschiebung von der UTC. Wenn Sie eine Zeitzone mit einer Zeitzonenabkürzung angeben, verwendet CONVERT_TIMEZONE die feste Verschiebung von UTC und nimmt keine Anpassungen an saisonale lokale Protokolle vor.

Verwenden POSIX-style Format

EIN POSIX-style Die Zeitzonenspezifikation ist in der Form stdOffset oder stdOffsetDST, wo STD ist eine Zeitzonenabkürzung, Offset ist der numerische Offset in Stunden westlich von UTC und DST ist eine optionale Abkürzung für die Sommerzone. Für die Sommerzeit wird angenommen, dass sie eine Stunde vor der angegebenen Verschiebung liegt.

POSIX-style Zeitzonenformate verwenden positive Offsets westlich von Greenwich, im Gegensatz zu ISO-8601 Konvention, bei der positive Offsets östlich von Greenwich verwendet werden.

Im Folgenden finden Sie Beispiele für POSIX-style Zeitzonen:

  • PST8

  • PST8PDT

  • EST5

  • EST5EDT

Anmerkung

Amazon Redshift wird nicht validiert POSIX-style Zeitzonenspezifikationen, daher ist es möglich, die Zeitzone auf einen ungültigen Wert einzustellen. Beispielsweise führt der folgende Befehl nicht zu einem Fehler, obwohl dadurch die Zeitzone auf einen ungültigen Wert gesetzt wird.

set timezone to ‘xxx36’;

Beispiele

Viele der Beispiele verwenden den TICKIT-Beispieldatensatz. Weitere Informationen finden Sie unter Beispieldatenbank.

Das folgende Beispiel konvertiert den Zeitstempelwert von der Standardzeitzone UTC zu PST.

select convert_timezone('PST', '2008-08-21 07:23:54'); convert_timezone ------------------------ 2008-08-20 23:23:54

Das folgende Beispiel konvertiert den Zeitstempelwert in der Spalte LISTTIME von der Standardzeitzone UTC zu PST. Obwohl der Zeitstempel in der Sommerzeitzone liegt, wird er zur Standardzeit konvertiert, da die Zielzeitzone als Abkürzung (PST) angegeben ist.

select listtime, convert_timezone('PST', listtime) from listing where listid = 16; listtime | convert_timezone --------------------+------------------- 2008-08-24 09:36:12 2008-08-24 01:36:12

Das folgende Beispiel konvertiert eine TIMESTAMP-LISTTIME-Spalte von der UTC-Standardzeitzone in US/Pacific Zeitzone. Die Zielzeitzone verwendet einen Zeitzonennamen, und der Zeitstempel liegt im Sommerzeitzeitraum, weshalb die Funktion die Sommerzeit ausgibt.

select listtime, convert_timezone('US/Pacific', listtime) from listing where listid = 16; listtime | convert_timezone --------------------+--------------------- 2008-08-24 09:36:12 | 2008-08-24 02:36:12

Das folgende Beispiel konvertiert eine Zeitstempelzeichenfolge von EST zu PST:

select convert_timezone('EST', 'PST', '20080305 12:25:29'); convert_timezone ------------------- 2008-03-05 09:25:29

Im folgenden Beispiel wird ein Zeitstempel in US Eastern Standard Time konvertiert, da die Zielzeitzone einen Zeitzonennamen verwendet (America/New_York) und der Zeitstempel liegt innerhalb des Standardzeitraums.

select convert_timezone('America/New_York', '2013-02-01 08:00:00'); convert_timezone --------------------- 2013-02-01 03:00:00 (1 row)

Im folgenden Beispiel wird der Zeitstempel in US Eastern Daylight Time konvertiert, da die Zielzeitzone einen Zeitzonennamen verwendet (America/New_York) und der Zeitstempel liegt innerhalb der Sommerzeit.

select convert_timezone('America/New_York', '2013-06-01 08:00:00'); convert_timezone --------------------- 2013-06-01 04:00:00 (1 row)

Das folgende Beispiel illustriert die Verwendung von Verschiebungen.

SELECT CONVERT_TIMEZONE('GMT','NEWZONE +2','2014-05-17 12:00:00') as newzone_plus_2, CONVERT_TIMEZONE('GMT','NEWZONE-2:15','2014-05-17 12:00:00') as newzone_minus_2_15, CONVERT_TIMEZONE('GMT','America/Los_Angeles+2','2014-05-17 12:00:00') as la_plus_2, CONVERT_TIMEZONE('GMT','GMT+2','2014-05-17 12:00:00') as gmt_plus_2; newzone_plus_2 | newzone_minus_2_15 | la_plus_2 | gmt_plus_2 ---------------------+---------------------+---------------------+--------------------- 2014-05-17 10:00:00 | 2014-05-17 14:15:00 | 2014-05-17 10:00:00 | 2014-05-17 10:00:00 (1 row)