TO_NUMBER

構文

図「to_number.gif」の説明

用途

TO_NUMBERは、exprを、NUMBERデータ型の値に変換します。exprは、CHAR、VARCHAR2、NCHAR、NVARCHAR2、BINARY_FLOATまたはBINARY_DOUBLEデータ型の数値にすることができます。

• CHAR、VARCHAR2、NCHARまたはNVARCHAR2データ型のexprを指定した場合は、オプションで書式モデルfmtを指定できます。

• BINARY_FLOATまたはBINARY_DOUBLEデータ型のexprを指定した場合、BINARY_FLOATまたはBINARY_DOUBLEは内部表現でのみ解釈できるため、書式モデルは指定できません。

書式モデルの詳細は、「書式モデル」を参照してください。

'nlsparam'引数は、数値変換のTO_CHARファンクションの場合と同じ用途に使用されます。詳細は、「TO_CHAR(数値)」を参照してください。

このファンクションは、CLOBデータを直接的にサポートしていません。ただし、暗黙的なデータ変換を使用してCLOBを引数として渡すことはできます。

関連項目: 詳細は、「データ型の比較規則」を参照してください。

例

次の例では、文字列データを数値に変換します。

UPDATE employees SET salary = salary + 
   TO_NUMBER('100.00', '9G999D99')
   WHERE last_name = 'Perkins';

SELECT TO_NUMBER('-AusDollars100','L9G999D99',
   ' NLS_NUMERIC_CHARACTERS = '',.''
     NLS_CURRENCY            = ''AusDollars''
   ') "Amount"
     FROM DUAL;

    Amount
----------
      -100