Amazon Redshift ne prendra plus en charge la création de nouveaux Python à UDFs partir du patch 198. UDFs Le Python existant continuera de fonctionner jusqu'au 30 juin 2026. Pour plus d’informations, consultez le [ billet de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

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="r_TO_NUMBER"></a>

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

**Note**  
Nous vous recommandons d’utiliser `FM` dans votre chaîne de format pour supprimer les blancs et les zéros de remplissage. Pour obtenir la liste des formats valides, consultez [Chaînes de format numériques](r_Numeric_formating.md).

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

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

## Arguments
<a name="r_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 `'FM99D999'` 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','FM99D999')` renvoie `12.345` comme une valeur numérique. Pour obtenir la liste des formats valides, consultez [Chaînes de format numériques](r_Numeric_formating.md). 

## Type de retour
<a name="r_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="r_TO_NUMBER-examples"></a>

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

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

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

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

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

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

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