本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# TO\$1NUMBER
<a name="TO_NUMBER"></a>

TO\$1NUMBER 將字串轉換為數值 (十進位)。

## 語法
<a name="TO_NUMBER-synopsis"></a>

```
to_number(string, format)
```

## 引數
<a name="TO_NUMBER-arguments"></a>

 *string*   
要轉換的字串。格式必須是文字值。

 *format*   
第二個引數是格式字串，指出如何剖析字元字串來建立數值。例如，格式 `'99D999'` 指定要轉換的字串包含五位數，且第三個位置是小數點。例如，`to_number('12.345','99D999')` 會將以數值傳回 `12.345`。如需有效格式的清單，請參閱[數值格式字串](Numeric_formating.md)。

## 傳回類型
<a name="TO_NUMBER-return-type"></a>

TO\$1NUMBER 傳回 DECIMAL 數字。

如果轉換成 *format* 失敗，則會傳回錯誤。

## 範例
<a name="TO_NUMBER-examples"></a>

下列範例將字串 `12,454.8-` 轉換為數字：

```
select to_number('12,454.8-', '99G999D9S');

to_number
-----------
-12454.8
```

下列範例將字串 `$ 12,454.88` 轉換為數字：

```
select to_number('$ 12,454.88', 'L 99G999D99');

to_number
-----------
12454.88
```

下列範例將字串 `$ 2,012,454.88` 轉換為數字：

```
select to_number('$ 2,012,454.88', 'L 9,999,999.99');

to_number
-----------
2012454.88
```