数字フォーマットモデル

数字フォーマットモデル（Number Format Models）は、データベースに格納される固定小数点数と浮動小数点数の形式を指定します。SQL文内でNUMBER、BINARY_FLOAT、またはBINARY_DOUBLE型の値をVARCHAR2データ型に変換する必要がある場合、関数内でこれらの数字フォーマットモデルを使用できます。

数字書式モデルの要素

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

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

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

• TO_CHAR 関数では、NUMBER、BINARY_FLOAT、または BINARY_DOUBLE データ型の値を VARCHAR2 データ型に変換します。

• TO_NUMBER 関数では、CHAR または VARCHAR2 データ型の値を NUMBER データ型に変換します。

• TO_BINARY_FLOAT および TO_BINARY_DOUBLE 関数では、CHAR および VARCHAR2 式を BINARY_FLOAT または BINARY_DOUBLE 型に変換します。

例

• 'S'形式の要素は、数値形式モデルの最初または最後にのみ配置できます。開始位置にある場合、正の数はプラス記号（+）を付けて返され、負の数はマイナス記号（-）を付けて返されます。終了位置にある場合、正の数はサフィックスのプラス記号（+）を付けて返され、負の数はサフィックスのマイナス記号（-）を付けて返されます。

  obclient> SELECT TO_CHAR(-1234567890, '9999999999S') FROM DUAL;
  +------------------------------------+
  | TO_CHAR(-1234567890,'9999999999S') |
  +------------------------------------+
  | 1234567890-                        |
  +------------------------------------+
  1 row in set
  
  obclient> SELECT TO_CHAR(1234567890, '9999999999S') FROM DUAL;
  +-----------------------------------+
  | TO_CHAR(1234567890,'9999999999S') |
  +-----------------------------------+
  | 1234567890+                       |
  +-----------------------------------+
  1 row in set
  

• '9'形式モデルは、指定された桁数の値を返します。正の数の場合は先頭にスペースを付けて返し、負の数の場合は先頭にマイナス記号を付けて返します。先頭のゼロは空ですが、ゼロ値は除きます。この値は固定小数点数の小数部がゼロとして返されます。以下の例のように、小数部は2つの'0'で補完されます。

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

• 結果がゼロの場合、'B'形式モデルはスペースを返します。

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

• 'FM'形式モデルは、先頭のスペースを除去することを示します。

  obclient> SELECT TO_CHAR(123.456, 'FM999.009') FROM DUAL;
  +------------------------------+
  | TO_CHAR(123.456,'FM999.009') |
  +------------------------------+
  | 123.456                      |
  +------------------------------+
  1 row in set
  

• 'EEEE'形式モデルは、値を科学計算書式で表すことを示します。

  obclient> SELECT TO_CHAR(123.456, '9.9EEEE') FROM DUAL;
  +----------------------------+
  | TO_CHAR(123.456,'9.9EEEE') |
  +----------------------------+
  |   1.2E+02                  |
  +----------------------------+
  1 row in set
  
  obclient> SELECT TO_CHAR(123.456, 'FM9.9EEEE') FROM DUAL;
  +------------------------------+
  | TO_CHAR(123.456,'FM9.9EEEE') |
  +------------------------------+
  | 1.2E+02                      |
  +------------------------------+
  1 row in set
  

• 'L '形式モデルは、指定された位置に現地通貨記号を返すことを示します。パラメータ NLS_CURRENCY が現在表す値が使用されます。

  obclient> SELECT TO_CHAR(123.456, 'FML999.99') FROM DUAL;
  +------------------------------+
  | TO_CHAR(123.456,'FML999.99') |
  +------------------------------+
  | $123.46                      |
  +------------------------------+
  1 row in set