Fonctions de conversion

Version:

2023.1

Last modified: May 17, 2023

Une fonction de conversion convertit un format ou un type de données en un autre format ou type de données. Utilisez une fonction de conversion pour convertir des nombres en chaînes ou vice-versa. Les fonctions de conversion peuvent être utilisées avec des données de type chaîne et numérique.

BinToInt

BinToInt(s) : convertit la chaîne binaire s en un entier. Cette option est limitée à 53 bits de précision et peut avoir jusqu'à 64 bits de longueur. Cela signifie que vous pouvez disposer, par exemple, d'une chaîne de 53 1 bits avec 10 0 bits.

Exemple

BinToInt("101010101") renvoie 341.

Si la chaîne fait exactement 32 ou 64 caractères de long, elle sera traitée comme un numéro à signe :
BinToInt("11111111111111111111111111111011") renvoie -5.

Les signes placés avant le nombre « + » et « - » ont la priorité sur le traitement des unités de 32 et 64 caractères comme des nombres à signe :
BinToInt("-111") renvoie -7,

BinToInt("+111") renvoie 7.

Tous les exemples suivants donnent la même valeur 9,223,372,036,854,774,784, ou 0x7FFFFFFFFFFFFC00 :
BinToInt("111111111111111111111111111111111111111111111111111101000000001") arrondit au chiffre supérieur,

BinToInt("111111111111111111111111111111111111111111111111111110000000000") exact,

BinToInt("111111111111111111111111111111111111111111111111111110111111111") arrondit au chiffre inférieur.

CharFromInt

CharFromInt(x) : renvoie le caractère Unicode® qui correspond au nombre d'entrée x.

Exemple

CharFromInt(66) renvoie B (U+0042 « lettre majuscule latine B »).

CharFromInt(169) renvoie © (U+00A9 « marque de copyright »).

CharFromInt(1071) renvoie Я (U+042F « lettre majuscule cyrillique YA »).

CharFromInt(127944) renvoie (U+1F3C8 « football américain »).

CharFromInt(0) renvoie [null] (U+000 « Null »), car un nombre entier qui ne peut pas être utilisé pour représenter un caractère peut renvoyer un résultat nul.

CharFromInt(55300) renvoie [null], car un nombre entier qui ne représente pas actuellement un caractère ne sera pas rendu par une police normale.

CharToInt

CharToInt(s) : renvoie le nombre qui correspond au caractère Unicode® d'entrée s.

Exemple

CharToInt("B") renvoie 66 (U+0042 « lettre majuscule latine B »).

CharToInt("©") renvoie 169 (U+00A9 « marque de copyright »).

CharToInt("Я") renvoie 1071 (U+042F « lettre majuscule cyrillique YA »).

CharToInt() renvoie 127944 (U+1F3C8 « football américain »).

ConvertFromCodePage

ConvertFromCodePage(s, codePage) : traduit le texte d'une page de code en Unicode. Pour en savoir plus sur les pages de code, consultez la documentation Pages de code.

ConvertToCodePage

ConvertToCodePage(s, codePage) : traduit le texte d'un encodage Unicode® en une page de code spécifique. Pour en savoir plus sur les pages de code, consultez la documentation Pages de code.

HexToNumber

HexToNumber(x) : convertit une chaîne hexadécimale (HEX) en nombre (limité à 53 bits).

Exemple

HexToNumber(dd) convertit au nombre 221.

IntToBin

IntToBin(x) : convertit x en chaîne binaire.

IntToHex

IntToHex(x) : convertit x en chaîne hexadécimale.

ToNumber

ToNumber(x, [bIgnoreErrors], [keepNulls], [decimalSeparator]) : convertit une chaîne (x) en nombre. ToNumber accepte les chaînes qui peuvent être interprétées comme une notation scientifique de double précision. Par défaut, le point est utilisé comme séparateur décimal.

Valeurs non numériques

ToNumber évalue la chaîne à partir du début et s'arrête lorsqu'une valeur non numérique est rencontrée (en ignorant les virgules, les points, les espaces et les apostrophes).

Par exemple, la chaîne « June 2022 » renvoie 0 ou [Null] (selon la configuration), alors que « 2022 June » renvoie 2022.

Paramètres facultatifs

bIgnoreErrors

(par défaut) 0 ou faux signale les messages d'erreur de conversion.
1 ou vrai ignore les erreurs de conversion.

keepNulls

(par défaut) 0 ou faux convertit les valeurs non numériques (y compris null) en zéro.
1 ou vrai convertit les valeurs non numériques en null.

decimalSeparator : séparateur décimal de la chaîne entrante.

(par défaut) « . » spécifie un point comme séparateur décimal.
« , » spécifie une virgule comme séparateur décimal.

Le paramètre decimalSeparator ignore le séparateur de milliers désigné (espace, point, virgule ou apostrophe) de la chaîne entrante.

Exemples

ToNumber("878") renvoie la chaîne 878 en tant que nombre.

ToNumber("4.256411411E9") renvoie la chaîne 4256411411 en tant que nombre.

ToNumber("Number", "false") renvoie 0 avec l'erreur de conversion : TONUMBER : le nombre a perdu des informations à la conversion.

ToNumber("Number", 0, 0) renvoie 0 avec l'erreur de conversion : TONUMBER : le nombre a perdu des informations à la conversion.

ToNumber("Number", 1, 0) renvoie la valeur 0 sans erreur de conversion.

ToNumber("Number", 1, 1) renvoie [Null] et aucune erreur de conversion.

ToNumber("123456,789", 1, 1, ",") renvoie 123456.789 en tant que nombre.

ToNumber("123.456,789", 1, 1, ",") renvoie 123456.789 en tant que nombre. En effet, le point est automatiquement interprété en tant que séparateur des milliers, alors que la virgule est utilisée en tant que séparateur décimal via decimalSeparator.

ToNumber("June 2022") renvoie la valeur 0. La fonction rencontre immédiatement une valeur non numérique et la convertit en valeur 0.

ToNumber("2022 June") renvoie 2022 en tant que nombre. La fonction s'arrête lorsqu'une valeur non numérique est rencontrée, le J dans June.

ToNumber("6/1/2022") renvoie 6 en tant que nombre. La fonction s'arrête lorsqu'une valeur non numérique est rencontrée, la barre oblique /.

ToNumber("2022 5:00:00") renvoie 20225 en tant que nombre. La fonction s'arrête lorsqu'une valeur non numérique est rencontrée, les deux points : après 5.

ToString

ToString(x, numDec, [addThousandsSeparator], [decimalSeparator]) : convertit un paramètre numérique (x) en chaîne en utilisant numDec décimales. La sélection par défaut utilise un point comme séparateur décimal.

Paramètres facultatifs

addThousandsSeparator

(par défaut) 0 formate la chaîne numérique sans séparateur de milliers.
1 formate avec un séparateur de milliers. Par défaut, le séparateur de milliers est une virgule sauf si « , » est spécifié pour decimalSeparator, auquel cas le séparateur de milliers sera un point.
« , » spécifie une virgule comme séparateur de milliers.
« . » spécifie un point comme séparateur de milliers.
« » spécifie une espace comme séparateur de milliers.
« ' » spécifie une apostrophe comme séparateur de milliers.

decimalSeparator :

(par défaut) « . » spécifie le point comme séparateur décimal.
« , » spécifie la virgule comme séparateur décimal.

Exemples

ToString(10, 0) renvoie 10 comme chaîne.

ToString(10.4, 2) renvoie 10,40 comme chaîne.

ToString(100.4, 2) renvoie 100,40 comme chaîne.

ToString(1000.4, 2, 1) renvoie 1 000,40 comme chaîne.

ToString(123456.789, 3, 1, ",") renvoie 123 456,789 comme chaîne.

ToString(123456.789, 3, 0, ",") renvoie 123456,789 comme chaîne.

ToString(1234567.89, 2, ".", ",") renvoie 1 234 567,89 comme chaîne.

ToString(1234567.89, 2, " ", ",") renvoie 1 234 567,89 comme chaîne.

ToString(1234567.89, 2, "'", ",") renvoie 1'234'567,89 comme chaîne.