Kategorien:: Konvertierungsfunktionen

TO_CHAR , TO_VARCHAR¶

Konvertiert den Eingabeausdruck in eine Zeichenfolge. Bei einer NULL-Eingabe lautet die Ausgabe NULL.

Diese Funktionen sind gleichbedeutend.

Syntax¶

TO_CHAR( <expr> )
TO_CHAR( <numeric_expr> [, '<format>' ] )
TO_CHAR( <date_or_time_expr> [, '<format>' ] )
TO_CHAR( <binary_expr> [, '<format>' ] )

TO_VARCHAR( <expr> )
TO_VARCHAR( <numeric_expr> [, '<format>' ] )
TO_VARCHAR( <date_or_time_expr> [, '<format>' ] )
TO_VARCHAR( <binary_expr> [, '<format>' ] )

Copy

Argumente¶

Benötigt:

expr: Ein Ausdruck eines beliebigen Datentyps.
numeric_expr: Ein numerischer Ausdruck.
date_or_time_expr: Ein Ausdruck vom Typ DATE, TIME oder TIMESTAMP.
binary_expr: Ein Ausdruck vom Typ BINARY oder VARBINARY.

Optional:

format

Das Format der Ausgabezeichenfolge:

Gibt bei numeric_expr das SQL-Formatierungsmodell an, das zur Interpretation des numerischen Ausdrucks verwendet wird. Weitere Informationen finden Sie unter SQL-Formatmodelle.
Gibt bei date_or_time_expr das erwartete Format zum Analysieren oder Erstellen einer Zeichenfolge an. Weitere Informationen finden Sie unter Datums- und Uhrzeitformate in Konvertierungsfunktionen.

Der Standardwert ist der aktuelle Wert folgender Sitzungsparameter:
- DATE_OUTPUT_FORMAT (bei DATE-Eingaben)
- TIME_OUTPUT_FORMAT (bei TIME-Eingaben)
- TIMESTAMP_OUTPUT_FORMAT (bei TIMESTAMP-Eingaben)
Gibt für den Binärausdruck binary_expr das Format an, in dem die Zeichenfolge erzeugt werden soll (z. B. HEX, BASE64 oder UTF-8).

Weitere Informationen dazu finden Sie unter Overview of Supported Binary Formats.

Nutzungshinweise¶

Bei den Eingaben VARIANT, ARRAY oder OBJECT ist die Ausgabe die Zeichenfolge, die ein JSON-Dokument oder einen JSON-Elementarwert enthält (es sei denn, VARIANT oder OBJECT enthielten ein XML-Tag; in diesem Fall wäre die Ausgabe eine Zeichenfolge, die ein XML-Dokument enthält):
- Eine in VARIANT gespeicherte Zeichenfolge bleibt erhalten (d. h. wird nicht in eine JSON-Zeichenfolge konvertiert).
- Ein JSON null-Wert wird in eine Zeichenfolge konvertiert, die das Wort „null“ enthält.

Beispiele¶

select to_varchar('2013-04-05 01:02:03'::timestamp, 'mm/dd/yyyy, hh24:mi hours');

+---------------------------------------------------------------------------+
| TO_VARCHAR('2013-04-05 01:02:03'::TIMESTAMP, 'MM/DD/YYYY, HH24:MI HOURS') |
|---------------------------------------------------------------------------|
| 04/05/2013, 01:02 hours                                                   |
+---------------------------------------------------------------------------+

Copy

select to_varchar('03-May-2013'::date);

+---------------------------------+
| TO_VARCHAR('03-MAY-2013'::DATE) |
|---------------------------------|
| 2013-05-03                      |
+---------------------------------+

Copy

select to_varchar('03-May-2013'::date, 'yyyy.mm.dd');

+-----------------------------------------------+
| TO_VARCHAR('03-MAY-2013'::DATE, 'YYYY.MM.DD') |
|-----------------------------------------------|
| 2013.05.03                                    |
+-----------------------------------------------+

Copy

select to_varchar(log(3,4));

+----------------------+
| TO_VARCHAR(LOG(3,4)) |
|----------------------|
| 1.261859507          |
+----------------------+

Copy

select column1 as orig_value,
   to_char(column1, '">"$99.0"<"') as D2_1,
   to_char(column1, '">"B9,999.0"<"') as D4_1,
   to_char(column1, '">"TME"<"') as TME,
   to_char(column1, '">"TM9"<"') as TM9,
   to_char(column1, '">"0XXX"<"') as X4,
   to_char(column1, '">"S0XXX"<"') as SX4
from values (-12.391), (0), (-1), (0.10), (0.01), (3987), (1.111);

+------------+----------+------------+-------------+------------+--------+---------+
| ORIG_VALUE | D2_1     | D4_1       | TME         | TM9        | X4     | SX4     |
|------------+----------+------------+-------------+------------+--------+---------|
|    -12.391 | >-$12.4< | >   -12.4< | >-1.2391E1< | >-12.391<  | >FFF4< | >-000C< |
|      0.000 | >  $0.0< | >      .0< | >0E0<       | >0.000<    | >0000< | >+0000< |
|     -1.000 | > -$1.0< | >    -1.0< | >-1E0<      | >-1.000<   | >FFFF< | >-0001< |
|      0.100 | >  $0.1< | >      .1< | >1E-1<      | >0.100<    | >0000< | >+0000< |
|      0.010 | >  $0.0< | >      .0< | >1E-2<      | >0.010<    | >0000< | >+0000< |
|   3987.000 | > $##.#< | > 3,987.0< | >3.987E3<   | >3987.000< | >0F93< | >+0F93< |
|      1.111 | >  $1.1< | >     1.1< | >1.111E0<   | >1.111<    | >0001< | >+0001< |
+------------+----------+------------+-------------+------------+--------+---------+

Copy