Partager via


Dec2Hex et Hex2Dec fonctions

S’applique à : Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages

Conversion entre des chaînes de texte hexadécimales et des nombres.

Description

Utilisez la Dec2Hex fonction pour convertir un nombre en chaîne de texte hexadécimal. Dec2Hexémet les caractères et 9 les caractères 0A majuscules à travers F; utilisez la fonction Lower pour convertir le résultat en minuscules si vous le souhaitez. Dec2Hex tronque le numéro d’entrée à un nombre entier comme si la fonction Tronc a été appliquée en premier. Utilisez Places pour compléter un nombre positif avec des 0 (zéros) non significatifs et limiter la longueur du résultat ; Places est ignoré si l’entrée est négative.

Utilisez la Hex2Dec fonction pour convertir une chaîne de texte contenant des chiffres hexadécimaux (0 à travers 9 et A à F) en un nombre. Les caractères majuscules et minuscules sont acceptés. Plus de 10 caractères hexadécimaux peuvent être passés à Hex2Dec.

Ces deux fonctions fonctionnent avec un nombre entier de 40 bits, en complément de deux. La plage de valeurs acceptées pour les deux fonctions va du nombre hexadécimal 8000000000 ou du nombre décimal -549755813888 au nombre hexadécimal 7FFFFFFFFF ou au nombre décimal 549755813887.

Si vous transmettez un nombre unique ou une chaîne de texte à ces fonctions, la valeur renvoyée est un résultat unique. Si vous transmettez une table à une seule colonne, la valeur renvoyée est une table de résultats à une seule colonne, avec un résultat pour chaque enregistrement dans la table de l’argument. Si vous avez une table à plusieurs colonnes, vous pouvez la convertir en table à une seule colonne, comme Utilisation des tables le décrit.

Si la valeur d’entrée est en dehors de la plage ou inclut des caractères hexadécimaux non valides, une erreur ErrorKind.Numeric est renvoyée. Si l’entrée était une table à une seule colonne, l’erreur est intégrée dans la table de sortie.

Syntaxe

Dec2Hex( Nombre [, Places] )

  • Numéro - Obligatoire. Nombre à convertir en hexadécimal.
  • Lieux - Facultatif. Nombre de caractères à utiliser si le nombre est positif. Si les emplacements sont omis, Dec2Hex utilise le nombre minimal de caractères nécessaires. Si ce paramètre est fourni et que le résultat ne rentre pas dans l’espace fourni, une erreur ErrorKind.Numeric est renvoyée. Les lieux sont ignorés si le nombre à convertir est négatif.

Hex2Dec( HexString )

  • HexString - Obligatoire. Chaîne de chiffres hexadécimaux à convertir en nombre.

Exemples

Utilisation de base de Hex2Dec

Formule Résultat
Hex2Dec( "A5" ) 165
Hex2Dec( "FFFFFFFF5B") -165
Hex2Dec( "c8d" ) 3213
Hex2Dec( "fffffff373" ) -3213
Hex2Dec( "ffffffffff" ) -1
Hex2Dec( "ffffffffffff" ) error (out of range)
Hex2Dec( "43j" ) error (invalid hexadecimal character)
Hex2Dec( [ "A", "12", "FFFF" ] ) [ 10, 18, 65535 ]
Hex2Dec( [ "3", "E", "I", "B" ] ) [ 3, 14, error (invalid hexadecimal character), 11 ]

Utilisation de base de Dec2Hex

Formule Résultat
Dec2Hex( 165 ) "A5"
Dec2Hex( -165 ) "FFFFFFFF5B"
Dec2Hex( 3213 ) "c8d"
Dec2Hex( -3213 ) "FFFFFFF373"
Dec2Hex( -1 ) "FFFFFFFFFF"
Dec2Hex( 3.74 ) "3"
Dec2Hex( -3.74 ) "FFFFFFFFFD"
Dec2Hex( [ 10, 255, -16 ] ) [ "A", "FF", "FFFFFFFFF0" ]
Dec2Hex( 1e45 ) error (out of range)
Dec2Hex( [ 1, 1e-45, 1e45, 2 ] ) [ "1", "0", error (out of range), "2" ]

Utilisation de base de l’argument Dec2Hex Places

Formule Résultat
Dec2Hex( 45780 ) "B2D4"
Dec2Hex( 45780, 4 ) "B2D4"
Dec2Hex( 45780, 5 ) "0B2D4"
Dec2Hex( 45780, 6 ) "00B2D4"
Dec2Hex( 45780, 3 ) error (not enough space)
Dec2Hex( 45780, 11 ) error (out of range)
Dec2Hex( -45780 ) "FFFFFF4D2C"
Dec2Hex( -45780, 4 ) "FFFFFF4D2C"
Dec2Hex( -45780, 6 ) "FFFFFF4D2C"
Dec2Hex( -45780, 10 ) "FFFFFF4D2C"
Dec2Hex( -45780, 11 ) error (out of range)

Utilisation de base avec Dec2Hex des tables de colonnes uniques et un argument Places

Formule Résultat
Dec2Hex( [ 10, 255, -16 ], [ 1, 2, 3 ] ) [ "A", "FF", "FFFFFFFFF0" ]
Dec2Hex( [ 10, 255, -16 ], 4 ) [ "000A", "00FF", "FFFFFFFFF0" ]
Dec2Hex( 255, [0, 1, 2, 3] ) [ error (not enough space), error (not enough space), "FF", "0FF" ]