TONUMBER

Syntaxe :

TONUMBER ( expression-texte-caractère-unique [ , expression-texte-unique ] )

Signification :

TONUMBER ( texte_à_convertir [ , chaîne_format_numérique ] )

Renvoie :

Un élément numérique caractères unique

TONUMBER renvoie le nombre correspondant à la valeur spécifiée par text_to_convert, au format indiqué dans number_format_string. Si text_to_convert n'est pas spécifié, le format de number_format_string pris en compte est le format décimal ANSI (par exemple, "{L-####['.'##]}")

number_format_string doit respecter les chaînes de format des nombres indiquées dans la rubrique "Chaînes de format".

Exemples

• TONUMBER(text_to_convert, "{L+'$'#','###}")

  L+'$' indique que le signe dollar de début est positif. Le signe de début et les séparateurs virgule sont supprimés lorsque le texte est converti en nombre.

  Chaîne d'entrée : $123,000,000

  Sortie : 123000000

• TONUMBER(text_to_convert, "{####T-}")

  Quatre signes numériques sont requis pour chaque nombre entier, quel que soit le nombre réel de chiffres dans le nombre.

  Chaîne en entrée :	Sortie :	Remarque :
  12345-	-12345	La sortie devient un nombre négatif.
  67890	67890	Aucune modification n'a lieu.
  345-	-345	La sortie devient un nombre négatif.

• TONUMBER(text_to_convert, "{####T+'K'-}")

  Si un caractère non valide, tel que X, est détecté, aucune valeur n'est renvoyée.

  Si K est détecté, il est traité comme un indicateur positif.

  Chaîne en entrée :	Sortie :	Remarque :
  11212-	-11212	La sortie devient un nombre négatif.
  67890X		X est un caractère non valide. Aucun nombre n'est renvoyé.
  54354	54354	Aucune modification n'a lieu.
  34567K	34567	K est reconnu en tant que signe positif. Le caractère est supprimé et le nombre est renvoyé en tant que positif.
  345-	-345	La sortie devient un nombre négatif.

• TONUMBER(text_to_convert, "{L-'('#','###T-')'}")

  Les parenthèses indiquent qu'un nombre négatif est supprimé et remplacé par un signe négatif.

  Les séparateurs virgule sont supprimés lorsque le texte est converti en nombre.

  Chaîne en entrée :	Sortie :	Remarque :
  (12,345)	-12345	La sortie devient un nombre négatif. Le séparateur virgule est supprimé.
  67,890	67890	Le séparateur virgule est supprimé.
  (345)	-345	La sortie devient un nombre négatif.

• TONUMBER(text_to_convert, "{#[',']###['.'##5]T+'K'-}")

  Les séparateurs virgule facultatifs sont supprimés mais les séparateurs décimaux ainsi que les valeurs décimales sont conservés.

  Chaîne en entrée :	Sortie :	Remarque :
  54,345.098	54354.098	Le séparateur virgule est supprimé.
  67890.0X		X est un caractère non valide. Aucun nombre n'est renvoyé.
  11213-	-11213	La sortie devient un nombre négatif.
  34567K	34567	K est reconnu en tant que signe positif. Le caractère est supprimé et le nombre est renvoyé en tant que positif.
  345.1-	-345.1	La sortie devient un nombre négatif.

Fonctions associées

• DATETONUMBER
• FROMNUMBER
• NUMBERTODATE
• NUMBERTOTEXT