数値書式モデル

数値書式モデルは、データベースに格納される固定小数点数と浮動小数点数の形式を指定します。SQLステートメント内でNUMBER、BINARY_FLOAT、またはBINARY_DOUBLE型の値をVARCHAR2データ型に変換する必要がある場合、関数内の数値書式モデルを使用できます。

関数における数値書式モデル

数値書式モデルは、以下の関数で使用できます：

• 式、条件、SQL関数、およびSQLステートメントに NUMBER、BINARY_FLOAT、または BINARY_DOUBLE が現れた場合、その値を VARCHAR2 データ型に変換する必要がある場合、TO_CHAR 関数のパラメータを使用してこれらの数値の書式を指定できます。

• 式、条件、SQL関数、およびSQLステートメントに CHAR または VARCHAR2 が現れた場合、その値を NUMBER データ型に変換する必要がある場合、TO_NUMBER 関数のパラメータ（NLS_NUMERIC_CHARACTERS は現在サポートされていません）を使用してこれらの数値の書式を指定できます。

• 式、条件、SQL関数、およびSQLステートメントに CHAR または VARCHAR2 が現れた場合、その値を BINARY_FLOAT または BINARY_DOUBLE に変換する必要がある場合、TO_BINARY_FLOAT および TO_BINARY_DOUBLE 関数のパラメータを使用して数値書式を指定できます。

数値書式モデルは、数値を四捨五入し、有効数字の桁数を取ります。値の小数点以下の桁数が、書式で指定された桁数よりも多い場合、その値は # で置き換えられます。

NUMBER の正の値が非常に大きく、指定された書式では表現できない場合、その値は無限大記号（〜）に置き換えられます。負の NUMBER 値が非常に小さく、指定された書式では表現できない場合、その値は負の無限大記号（-〜）に置き換えられます。

デジタルフォーマットモデルの要素

数字書式要素

数字書式モデルは、1つ以上の数字書式要素で構成されます。負の戻り値には自動的に先頭のマイナス記号が付き、正の値には自動的に先頭のスペースが付きます。ただし、書式モデルにMI、S、PRなど、数字の正負を示す書式要素が含まれている場合はこの限りではありません。

次の表は、数字書式モデルに含まれる要素とその具体的な使用方法を示しています。

フォーマット要素による変換例

次の表は、異なる数値に対してフォーマット要素のパラメータ fmt を指定し、SQLコマンド SELECT TO_CHAR(number, 'fmt') FROM DUAL; を実行した場合の変換結果を示しています。フォーマットモデルパラメータ fmt を省略した場合、数値はすべての有効数字を保持するために十分に長い VARCHAR2 に変換されます。

例

• 数値0を小数点以下2桁の有効数字を持つ値に変換します。

  obclient> SELECT TO_CHAR(0, '99.99') FROM DUAL;
  +--------------------+
  | TO_CHAR(0,'99.99') |
  +--------------------+
  |    .00             |
  +--------------------+
  1 row in set
  

• fmtパラメータを省略し、その値のすべての有効数字を保持します。

  obclient> SELECT TO_CHAR(123.456) FROM DUAL;
  +------------------+
  | TO_CHAR(123.456) |
  +------------------+
  | 123.456          |
  +------------------+
  1 row in set
  

• TO_CHARの結果が40バイトを超える場合、または渡されたパラメータがBINARY_DOUBLEまたはBINARY_FLOAT型の場合、結果は科学記数法に変換されます。

  obclient> SELECT TO_CHAR(12355555555555555555555555555555555555555555555555) FROM DUAL;
  +-------------------------------------------------------------+
  | TO_CHAR(12355555555555555555555555555555555555555555555555) |
  +-------------------------------------------------------------+
  | 1.2355555555555555555555555555555556E+49                    |
  +-------------------------------------------------------------+
  1 row in set