デジタルフォーマットモデル

デジタルフォーマットモデル（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