Inhaltsverzeichnis

Search

  1. Vorwort
  2. Umwandlungssprache
  3. Konstanten
  4. Operatoren
  5. Variablen
  6. Datumsangaben
  7. Funktionen

Referenzhandbuch für die Umwandlungssprache

Referenzhandbuch für die Umwandlungssprache

TO_TIMESTAMP_TZ

TO_TIMESTAMP_TZ

Wandelt eine Zeichenfolge in einen „Zeitstempel mit Zeitzone“-Wert um. Die Funktion gibt den Datentyp „Zeitstempel mit Zeitzone“ zurück. Mit den TO_TIMESTAMP_TZ-Formatzeichenfolgen geben Sie das Format der Quellzeichenfolgen an.

Syntax

TO_TIMESTAMP_TZ (
String
, [
format
] )
In der folgenden Tabelle werden die Argumente für diesen Befehl beschrieben:
Argument
Erforderlich/
Optional
Beschreibung
Zeichenfolge
Erforderlich
Muss vom Datentyp „Zeichenfolge“ sein. Übergibt die Werte, die Sie in Zeitstempel mit Zeitzone umwandeln möchten. Sie können einen beliebigen gültigen Umwandlungsausdruck eingeben.
Die Zeichenfolge muss eine Zeichenfolge sein.
format
Optional
Geben Sie eine gültige TO_TIMESTAMP_TZ-Formatzeichenfolge ein. Die Formatzeichenfolge muss den Teilen des Zeichenfolgenarguments entsprechen. Wenn Sie beispielsweise die Zeichenfolge 'Mar 15 1997 12:43:10AM ASIA/CALCUTTA' übergeben, müssen Sie die Formatzeichenfolge 'MON DD YYYY HH12:MI:SSAM TZR' verwenden.
Wenn Sie die Formatzeichenfolge nicht angeben, verwendet die Funktion das Standardformat für Datum/Uhrzeit im Dialogfeld „Konfigurationen ausführen“.

Rückgabewert

Gibt einen Zeitstempel mit dem Datentyp „Zeitzone“ zurück.
NULL, wenn die Eingabe ein Nullwert ist.
Wenn der an die Funktion übergebene Wert Daten enthält, die für einen Zeitstempel mit Zeitzone-Wert nicht gültig sind, markiert der Datenintegrationsdienst die Zeile als Fehlerzeile oder die Zuordnung schlägt fehl.
Beispiel
INPUT VALUE
RETURN VALUE
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM TZR'
Gibt den Datentyp „Zeitstempel mit Zeitzone“ mit den folgenden Daten zurück:
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES’
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, 'YYYY-MM-DD HH:MI:SS.NS AM'
Gibt den Datentyp „Zeitstempel mit Zeitzone“ auch dann zurück, wenn die Zeitzonenregion nicht im Format der Zeitzonenregion angegeben wird:
‘1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’
Gibt den Datentyp „Zeitstempel mit Zeitzone“ auch dann zurück, wenn das Format „Zeitstempel mit Zeitzone“ nicht angegeben wird.
'1947-08-05 10:45:00.221111000 AM AMERICA/LOS_ANGELES'
Das Standardformat für Datum/Uhrzeit im Dialogfeld „Konfigurationen ausführen“ wird verwendet, wenn das Format nicht auf der Funktionsebene angegeben wird.
Standardformat für Datum/Uhrzeit:
'YYYY-MM-DD HH:MI:SS.NS AM TZR'
‘1947-08-05 10:45:00.221111000 AM America/Los_Angeles’, ’MM-DD-YYYY HH:MI:SS.NS AM'
Wenn „Zeitstempel mit Zeitzone“-Daten nicht mit dem angegebenen Format übereinstimmen, wird folgender Fehler angezeigt:
Process row failed for function [TO_TIMESTAMP_TZ]: Failed to convert the string to timestamp with time zone value. Verify that the specified date format string is valid. Verify that the timestamp with time zone string used in the first argument is compatible with the specified date format.