説明
この関数は、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