Vorwort
Umwandlungssprache
Konstanten
Operatoren
Variablen
- Integrierte Variablen
  - SYSDATE
    - Beispiel
- Lokale Variablen
Datumsangaben
Funktionen
- Funktionskategorien
  - Aggregatfunktionen
  - Aggregatfunktionen und Nullen
    - Filterbedingungen
  - Zeichenfunktionen
  - Konvertierungsfunktionen
  - Datenbereinigungsfunktionen
  - Datumsfunktionen
  - Kodierungsfunktionen
  - Finanzfunktionen
  - Numerische Funktionen
  - Wissenschaftliche Funktionen
  - Spezialfunktionen
  - Stringfunktionen
  - Testfunktionen
- ABORT
- ABS
- ADD_TO_DATE
- AES_DECRYPT
- AES_ENCRYPT
- ANY
- ASCII
- AVG
- CEIL
- CHOOSE
- CHR
- CHRCODE
- COMPRESS
- CONCAT
- CONVERT_BASE
- COS
- COSH
- COUNT
- CRC32
- CREATE_TIMESTAMP_TZ
- CUME
- DATE_COMPARE
- DATE_DIFF
- DEC_BASE64
- DECODE
- DECOMPRESS
- ENC_BASE64
- ERROR
- EXP
- FIRST
- FLOOR
- FV
- GET_DATE_PART
- GET_TIMEZONE
- GET_TIMESTAMP
- GREATEST
- IIF
- IN
- INDEXOF
- INITCAP
- INSTR
- ISNULL
- IS_DATE
- IS_NUMBER
- IS_SPACES
- LAST
- LAST_DAY
- LEAST
- LENGTH
- LN
- LOG
- LOWER
- LPAD
- LTRIM
- MAKE_DATE_TIME
- MAX (Datum)
- MAX (Zahlen)
- MAX (String)
- MD5
- MEDIAN
- METAPHONE
- MIN (Datum)
- MIN (Zahlen)
- MIN (String)
- MOD
- MOVINGAVG
- MOVINGSUM
- NPER
- PERCENTILE
- PMT
- POWER
- PV
- RAND
- RATE
- REG_EXTRACT
- REG_MATCH
- REG_REPLACE
- REPLACECHR
- REPLACESTR
- REVERSE
- ROUND (Datum)
- ROUND (Zahlen)
- RPAD
- RTRIM
- SET_DATE_PART
- SIGN
- SIN
- SINH
- SOUNDEX
- SQL_LIKE
- SQRT
- STDDEV
- SUBSTR
- SUM
- SYSTIMESTAMP
- TAN
- TANH
- TO_BIGINT
- TO_CHAR (Datum)
- TO_CHAR (Zahlen)
- TO_DATE
- TO_DECIMAL
- TO_DECIMAL38
- TO_FLOAT
- TO_INTEGER
- TO_TIMESTAMP_TZ
- TRUNC (Datum)
- TRUNC (Zahlen)
- UPPER
- UUID4
- UUID_UNPARSE
- VARIANCE

Referenzhandbuch für die Umwandlungssprache

10.1.1

Zurück Weiter

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

Funktionen

Handbuch herunterladen

Feedback senden

Communities

Knowledge Base

Erfolgsportal

Rename Saved Search

Inhaltsverzeichnis

Referenzhandbuch für die Umwandlungssprache

Referenzhandbuch für die Umwandlungssprache

TO_CHAR (Datum)

TO_CHAR (Datum)

Syntax

Rückgabewert

Beispiele

Tipp