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_CHAR (Datum)

TO_CHAR (Datum)

Konvertiert Datumsangaben in Zeichenstrings. TO_CHAR wandelt auch numerische Werte in Strings um. Mithilfe der TO_CHAR-Formatstrings können Sie das Datum in jedes beliebige Format konvertieren.
TO_CHAR (date [,format]) wandelt einen Datentyp oder internen Wert vom Datentyp „Datum“, „Zeitstempel“, „Zeitstempel mit Zeitzone“ oder „Zeitstempel mit lokaler Zeitzone“ in einen Wert vom Datentyp „Zeichenfolge“ um, der durch die Formatzeichenfolge angegeben wird.

Syntax

TO_CHAR(
date
[,
format
] )
In der folgenden Tabelle werden die Argumente für diesen Befehl beschrieben:
Argument
Erforderlich/
Optional
Beschreibung
date
Erforderlich
Datum/Zeit-Datentyp. Übergibt die Datumswerte, die in Zeichenfolgen umgewandelt werden sollen. Sie können einen beliebigen gültigen Umwandlungsausdruck eingeben.
format
optional
Geben Sie eine gültige TO_CHAR-Formatzeichenfolge ein. Die Formatzeichenfolge definiert das Format des Rückgabewerts, nicht aber das Format der Werte im Date-Argument. Wenn Sie die Formatzeichenfolge auslassen, gibt die Funktion eine Zeichenfolge zurück, die auf dem in der Zuordnungskonfiguration festgelegten Datumsformat basiert.

Rückgabewert

Zeichenfolge.
NULL, falls ein an die Funktion übergebener Wert NULL ist.

Beispiele

Der folgende Ausdruck wandelt die Daten im Port DATE_PROMISED in Text im Format MON DD YYYY um:
TO_CHAR( DATE_PROMISED, 'MON DD YYYY' )
DATE_PROMISED
RETURN VALUE
Apr 1 1998 12:00:10AM
'Apr 01 1998'
Feb 22 1998 01:31:10PM
'Feb 22 1998'
Oct 24 1998 02:12:30PM
'Oct 24 1998'
NULL
NULL
Wenn Sie
format
nicht angeben, gibt TO_CHAR den String im Datumsformat der Mapping-Konfiguration zurück, standardmäßig MM/DD/YYYY HH24:MI:SS.US:
TO_CHAR( DATE_PROMISED )
DATE_PROMISED
RETURN VALUE
Apr 1 1998 12:00:10AM
'04/01/1998 00:00:10.000000'
Feb 22 1998 01:31:10PM
'02/22/1998 13:31:10.000000'
Oct 24 1998 02:12:30PM
'10/24/1998 14:12:30.000000'
NULL
NULL
Die folgenden Ausdrücke geben den Wochentag aller Datumsangaben in einem Port zurück:
TO_CHAR( DATE_PROMISED, 'D' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'3'
02-22-1997 01:31:10PM
'7'
10-24-1997 02:12:30PM
'6'
NULL
NULL
TO_CHAR( DATE_PROMISED, 'DAY' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'Tuesday'
02-22-1997 01:31:10PM
'Saturday'
10-24-1997 02:12:30PM
'Friday'
NULL
NULL
Der folgende Ausdruck gibt den Tag des Monats aller Datumsangaben in einem Port zurück:
TO_CHAR( DATE_PROMISED, 'DD' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'01'
02-22-1997 01:31:10PM
'22'
10-24-1997 02:12:30PM
'24'
NULL
NULL
Der folgende Ausdruck gibt den Tag des Jahres aller Datumsangaben in einem Port zurück:
TO_CHAR( DATE_PROMISED, 'DDD' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'091'
02-22-1997 01:31:10PM
'053'
10-24-1997 02:12:30PM
'297'
NULL
NULL
Die folgenden Ausdrücke geben die Stunde des Tages aller Datumsangaben in einem Port zurück:
TO_CHAR( DATE_PROMISED, 'HH' ) TO_CHAR( DATE_PROMISED, 'HH12' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'12'
02-22-1997 01:31:10PM
'01'
10-24-1997 02:12:30PM
'02'
NULL
NULL
TO_CHAR( DATE_PROMISED, 'HH24' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'00'
02-22-1997 01:31:10PM
'13'
10-24-1997 11:12:30PM
'23'
NULL
NULL
Der folgende Ausdruck konvertiert Datumswerte in MJD-Werte, ausgedrückt als Strings:
TO_CHAR( SHIP_DATE, 'J')
SHIP_DATE
RETURN_VALUE
Dec 31 1999 03:59:59PM
2451544
Jan 1 1900 01:02:03AM
2415021
Der folgende Ausdruck konvertiert Daten in Strings im Format „MM/DD/YY“:
TO_CHAR( SHIP_DATE, 'MM/DD/RR')
SHIP_DATE
RETURN_VALUE
12/31/1999 01:02:03AM
12/31/99
09/15/1996 03:59:59PM
09/15/96
05/17/2003 12:13:14AM
05/17/03
Sie können auch den SSSSS-Formatstring in TO_CHAR-Ausdrücken einsetzen. Beispiel: Der folgende Ausdruck konvertiert die Daten im Port SHIP_DATE in Strings mit Angabe der Gesamtzahl der Sekunden seit Mitternacht:
TO_CHAR( SHIP_DATE, 'SSSSS')
SHIP_DATE
RETURN_VALUE
12/31/1999 01:02:03AM
3783
09/15/1996 03:59:59PM
86399
In TO_CHAR-Ausdrücken erzielt der YY-Formatstring dieselben Ergebnisse wie der RR-Formatstring.
Der folgende Ausdruck konvertiert Daten in Strings im Format „MM/DD/YY“:
TO_CHAR( SHIP_DATE, 'MM/DD/YY')
SHIP_DATE
RETURN_VALUE
12/31/1999 01:02:03AM
12/31/99
09/15/1996 03:59:59PM
09/15/96
05/17/2003 12:13:14AM
05/17/03
Der folgende Ausdruck gibt die Woche des Monats aller Datumsangaben in einem Port zurück:
TO_CHAR( DATE_PROMISED, 'W' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10AM
'01'
02-22-1997 01:31:10AM
'04'
10-24-1997 02:12:30PM
'04'
NULL
NULL
Der folgende Ausdruck gibt die Woche des Jahres aller Datumsangaben in einem Port zurück:
TO_CHAR( DATE_PROMISED, 'WW' )
DATE_PROMISED
RETURN VALUE
04-01-1997 12:00:10PM
'18'
02-22-1997 01:31:10AM
'08'
10-24-1997 02:12:30AM
'43'
NULL
NULL

Tipp

TO_CHAR und TO_DATE können kombiniert werden, z. B. zum Konvertieren eines numerischen Werts für einen Monat in einen Textwert für einen Monat mithilfe einer Funktion:
TO_CHAR( TO_DATE( numeric_month, 'MM' ), 'MONTH' )