Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。

# TO\_NUMBER
<a name="r_TO_NUMBER"></a>

TO\_NUMBER は、文字列を数値 (10 進) に変換します。

**注記**  
パディングの空白とゼロを抑制するには、フォーマット文字列で `FM` を使用することをお勧めします。有効な形式の一覧については、「[数値形式の文字列](r_Numeric_formating.md)」を参照してください。

## 構文
<a name="r_TO_NUMBER-synopsis"></a>

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

## 引数
<a name="r_TO_NUMBER-arguments"></a>

 *string*   
変換する文字列。形式はリテラル値である必要があります。

 *format*   
2 番目の引数は、数値を作成するために文字列を解析する方法を示す書式文字列です。例えば、形式 `'FM99D999'` では、変換する文字列が 5 つの数字で構成され、3 番目の位置に小数点が挿入されます。たとえば、`to_number('12.345','FM99D999')`は数値として `12.345` を返します。有効な形式の一覧については、「[数値形式の文字列](r_Numeric_formating.md)」を参照してください。

## 戻り型
<a name="r_TO_NUMBER-return-type"></a>

TO\_NUMBER は DECIMAL 型の数値を返します。

*フォーマット*への変換が失敗すると、エラーが返されます。

## 例
<a name="r_TO_NUMBER-examples"></a>

次の例では、文字列 `12,454.8-` を数値に変換します。

```
select to_number('12,454.8-', 'FM99G999D9S');

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

次の例では、文字列 `$ 12,454.88` を数値に変換します。

```
select to_number('$ 12,454.88', 'FML99G999D99');

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

次の例では、文字列 `$ 2,012,454.88` を数値に変換します。

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

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