Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

TO\$1NUMBER convertit une chaîne en une valeur numérique (décimale). 

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

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

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

 *string*   
Chaîne à convertir. Le format doit être une valeur littérale. 

 *format*   
Le deuxième argument est une chaîne de format qui indique comment la chaîne de caractères doit être analysée afin de créer la valeur numérique. Par exemple, le format `'99D999'` spécifie que la chaîne à convertir se compose de cinq chiffres, avec la virgule à la troisième position. Par exemple, `to_number('12.345','99D999')` renvoie `12.345` comme une valeur numérique. Pour obtenir la liste des formats valides, consultez [Chaînes de format numériques](Numeric_formating.md). 

## Type de retour
<a name="TO_NUMBER-return-type"></a>

TO\$1NUMBER renvoie un nombre DECIMAL. 

Si la conversion au *format* échoue, une erreur est renvoyée. 

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

L’exemple suivant convertit la chaîne `12,454.8-` en un nombre : 

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

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

L’exemple suivant convertit la chaîne `$ 12,454.88` en un nombre : 

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

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

L’exemple suivant convertit la chaîne `$ 2,012,454.88` en un nombre : 

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

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