O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](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 converte uma string em um valor numérico (decimal). 

**nota**  
Recomendamos que você use `FM` em sua string de formato para suprimir espaços em branco e zeros de preenchimento. Para obter uma lista dos formatos válidos, consulte [Strings de formato numérico](r_Numeric_formating.md).

## Sintaxe
<a name="r_TO_NUMBER-synopsis"></a>

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

## Argumentos
<a name="r_TO_NUMBER-arguments"></a>

 *string*   
String a ser convertida. O formato deve ser um valor literal. 

 *formato*   
O segundo argumento é uma string de formato que indica como a string de caracteres deve ser analisada para criar o valor numérico. Por exemplo, o formato `'FM99D999'` especifica que a string a ser convertida consiste em cinco dígitos com o ponto decimal na terceira posição. Por exemplo, `to_number('12.345','FM99D999')` retorna `12.345` como um valor numérico. Para obter uma lista dos formatos válidos, consulte [Strings de formato numérico](r_Numeric_formating.md). 

## Tipo de retorno
<a name="r_TO_NUMBER-return-type"></a>

TO\_NUMBER retorna um número DECIMAL. 

Se ocorrer falha na conversão no *formato*, um erro será gerado. 

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

O exemplo a seguir converte a string `12,454.8-` em um número: 

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

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

O exemplo a seguir converte a string `$ 12,454.88` em um número: 

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

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

O exemplo a seguir converte a string `$ 2,012,454.88` em um número: 

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

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