説明
この関数は、NUMBER、BINARY_FLOAT、または BINARY_DOUBLE 型の数値を指定された数値フォーマットに従って VARCHAR2 データ型の値に変換します。
構文
TO_CHAR(n [, fmt [, 'nlsparam' ] ])
パラメータの説明
パラメータ |
説明 |
|---|---|
| n | NUMBER、BINARY_FLOAT または BINARY_DOUBLE 型の数値です。 説明 n が負の場合、負号は出力値の左端に表示されます。例えば、TO_CHAR(-1,'$9') は $-1 ではなく -1 を返します。 |
| fmt | 出力形式を指定するオプションパラメータです。fmt を省略した場合、n は VARCHAR2 値に変換されます。詳細については、fmt パラメータのリストを参照してください。 |
| nlsparam | 十進数文字、桁区切り文字、現地通貨記号、国際通貨記号を定義するためのオプションパラメータです。 |
fmt パラメータリスト
fmtパラメータの値 |
説明 |
|---|---|
| 9 | 指定された桁数の値を返します。 |
| 0 | 前導きの0を返します。 |
| ,（カンマ） | 指定された位置のカンマを返します。数値書式モデルで複数のカンマを指定できます。 制限条件 ：書式モデルの数値はカンマで始まってはならず、カンマは小数文字やピリオドの右側には来てはなりません。 |
| .（小数点） | 小数を返し、小数点は指定された位置に配置されます。 制限条件 ：数値書式モデルでは、小数点は1つだけ指定できます。 |
戻り値の型
VARCHAR2 データ型を返します。
例
123456789.123 を 999,999,999 形式の値に変換します。
obclient> SELECT TO_CHAR(123456789.123,'999,999,999') FROM DUAL;
+--------------------------------------+
| TO_CHAR(123456789.123,'999,999,999') |
+--------------------------------------+
| 123,456,789 |
+--------------------------------------+
1 row in set