数値書式モデル

数値書式モデルは、次の関数で使用します。

  • NUMBERBINARY_FLOATまたはBINARY_DOUBLEデータ型の値をVARCHAR2データ型に変換するTO_CHAR関数。

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

デフォルトのamerican_america NLS言語および地域の設定が使用されます。

数値書式モデルは、1つ以上の数値書式要素で構成されます。次の表に、数値書式モデルの要素を示します。数値書式モデルに書式要素MISまたはPRが指定されないかぎり、負の戻り値の先頭には自動的に負の符号が付けられ、正の戻り値の先頭には空白が付けられます。

表3-1 数値書式要素

要素 説明

, (カンマ)

9,999

指定された位置にカンマを戻します。1つの数値書式モデルに複数のカンマを指定できます。

制限:

  • 数値書式モデルでは、先頭をカンマ要素にすることはできません。

  • 数値書式モデルでは、小数点文字(ピリオド)の右側にカンマは使用できません。

. (ピリオド)

99.99

指定された位置に小数点(ピリオド(.))を戻します。

制限:

1つの書式モデルで指定できるピリオドは1つのみです。

$

$9999

先行ドル記号を含む値を戻します。

0

0999

9990

先行0 (ゼロ)を戻します。

後続0 (ゼロ)を戻します。

9

9999

指定された桁数の値を戻します。正の場合は先行空白が含まれ、負の場合は先行マイナスが含まれます。

固定小数点数の整数部分の場合、先行0(ゼロ)に対して空白を戻します。ただし、値0(ゼロ)に対しては0(ゼロ)を戻します。

B

B9999

固定小数点数の整数部分が0(ゼロ)の場合、空白を戻します(書式モデル内の0(ゼロ)には関係ありません)。

C

C999

指定された位置にISO通貨記号を戻します。

D

99D99

指定された位置に小数点文字を戻します。デフォルトはピリオド(.)です。

制限:

1つの数値書式モデルで指定できる小数点文字は1つのみです。

EEEE

9.9EEEE

科学表記法で値を戻します。

G

9G999

指定された位置にグループ・セパレータを戻します。1つの数値書式モデルに複数のグループ・セパレータを指定できます。

制限:

数値書式モデルでは、小数点文字(ピリオド)の右側にグループ・セパレータは使用できません。

L

L999

指定した位置にローカル通貨記号を戻します。

MI

999MI

後続のマイナス符号(-)を含む負の値を戻します。

後続の空白を含む正の値を戻します。

制限:

MI書式の要素は、数値書式モデルの末尾にのみ使用できます。

PR

999PR

山カッコ(< >)の中に負の値を戻します。

先行および後続の空白を含む正の値を戻します。

制限:

PR書式の要素は、数値書式モデルの末尾にのみ使用できます。

RN

RN

値を大文字のローマ数字として戻します。

rn

rn

値を小文字のローマ数字として戻します。

1から3999までの整数を値として指定できます。

S

S9999

先行のマイナス符号(-)を含む負の値を戻します。

先行のプラス符号(+)を含む正の値を戻します。

S

9999S

後続のマイナス符号(-)を含む負の値を戻します。

後続のプラス符号(+)を含む正の値を戻します。

制限:

S書式の要素は、数値書式モデルの先頭または末尾にのみ使用できます。

TM

TM

テキストの最小数値書式モデルは、文字の最小数を(10進出力で)戻します。この要素の大文字と小文字は区別されません。

デフォルトはTM9で、出力が64文字を超えないかぎり、固定表記法で数値を戻します。出力が64文字を超える場合は、TimesTenによって自動的に科学表記法で数値が戻されます。

制限:

  • この要素の前に他の要素を指定することはできません。

  • この要素の後に、9を1つか、Eを1つか、または(e)を指定できますが、これらを組み合せることはできません。次の文は、エラーを戻します。

    SELECT TO_NUMBER (1234, 'TM9e') FROM dual;

U

U9999

指定された位置にユーロまたは他の二重通貨記号を戻します。

V

999V99

10nを乗算した値を戻します(この値は必要に応じて丸められます)。nVに続く9の数です。

X

XXXX

指定された桁数の16進値を戻します。指定された数値が整数でない場合は、TimesTenによって整数に丸められます。

制限:

  • この要素は、正の値または0(ゼロ)のみを受け入れます。負の値はエラーを戻します。

  • この要素の前には、先行の0(ゼロ)を戻す0(ゼロ)またはFMのみを指定できます。その他の要素はすべてエラーを戻します。Xに0(ゼロ)もFMも指定しない場合は、常に戻り値に先行空白が含まれます。