Dec2Hex‑ und Hex2Dec-Funktionen
Gilt für:
Canvas-Apps Dataverse Low-Code-Plug-Ins Desktop-Flows Modellgesteuerte Apps Power Platform CLI
Konvertieren Sie zwischen hexadezimalen Textzeichenfolgen und Zahlen.
Description
Verwenden Sie die Funktion Dec2Hex, um eine Nummer in eine hexadezimale Textzeichenfolge umzuwandeln. Dec2Hex gibt die Zeichen 0 bis 9 und Großbuchstaben A bis F aus. Verwenden Sie die Funktion Lower, um das Ergebnis bei Bedarf in Kleinbuchstaben umzuwandeln. Dec2Hex kürzt die eingegebene Zahl auf eine ganze Zahl, als ob die Funktion Trunc zuerst angewendet worden wäre. Verwenden Sie Places um eine positive Zahl mit führenden 0s (Nullen) aufzufüllen und die Länge der Ausgabe zu begrenzen. Places wird ignoriert, wenn die Eingabe negativ ist.
Verwenden Sie die Funktion Hex2Dec , um eine Textzeichenfolge mit hexadezimalen Ziffern (0 bis 9 und A bis F) zu einer Zahl zu konvertieren. Es werden Groß- und Kleinbuchstaben akzeptiert. An Hex2Dec können nicht mehr als 10 hexadezimale Zeichen übergeben werden.
Beide Funktionen arbeiten mit einer 40-Bit-Zweierkomplement-Ganzzahl. Der Bereich der akzeptierten Werte für beide Funktionen ist hexadezimal 8000000000 oder dezimal -549755813888 bis hexadezimal 7FFFFFFFFF oder dezimal 549755813887.
Wenn Sie diesen Funktionen eine einzelne Zahl oder eine Textzeichenfolge übergeben, ist der Rückgabewert ein einzelnes Ergebnis. Wenn Sie eine einspaltige Tabelle übergeben, ist der Rückgabewert eine einspaltige Tabelle mit Ergebnissen, ein Ergebnis für jeden Datensatz in der Argumenttabelle. Mehrspaltige Tabellen können in einspaltige Tabellen umgeformt werden, wie unter Arbeiten mit Tabellen beschrieben wird.
Wenn der Eingabewert außerhalb des gültigen Bereichs liegt oder ungültige Hexadezimalzeichen enthält, wird ein Fehler ErrorKind.Numeric zurückgegeben. Wenn die Eingabe eine einspaltige Tabelle war, wird der Fehler in die Ausgabetabelle eingebettet.
Syntax
Dec2Hex( Number [, Places] )
- Number – Erforderlich. In Hexadezimalzahl umzuwandelnde Zahl.
- Orte – Optional. Die Anzahl der zu verwendenden Zeichen, wenn die Zahl positiv ist. Wenn Places weggelassen wird, verwendet Dec2Hex die minimal erforderliche Anzahl an Zeichen. Wenn dieser Parameter angegeben wird und das Ergebnis nicht in den bereitgestellten Platz passt, wird ein Fehler ErrorKind.Numeric zurückgegeben. Places wird ignoriert, wenn die zu konvertierende Zahl negativ ist.
Hex2Dec( HexString )
- HexString – Erforderlich. Zeichenfolge aus hexadezimalen Ziffern, die in eine Zahl umgewandelt werden sollen.
Beispiele
Grundlegende Verwendung von Hex2Dec
| Formel | Result |
|---|---|
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 ] |
Grundlegende Verwendung von Dec2Hex
| Formel | Result |
|---|---|
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" ] |
Grundlegende Verwendung von Dec2Hex mit Places-Argument
| Formel | Result |
|---|---|
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) |
Grundlegende Verwendung von Dec2Hex mit einspaltigen Tabellen und dem Places-Argument
| Formel | Result |
|---|---|
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" ] |