As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

TO\$1NUMBER converte uma string em um valor numérico (decimal). 

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

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

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

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

 *format*   
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 `'99D999'` 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','99D999')` retorna `12.345` como um valor numérico. Para obter uma lista dos formatos válidos, consulte [Strings de formato numérico](Numeric_formating.md). 

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

TO\$1NUMBER retorna um número DECIMAL. 

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

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

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

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

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

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

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

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', 'L 9,999,999.99');

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