Freigeben über


Dec2Hex und Hex2Dec Funktionen

Gilt für: Canvas-Apps Copilot Studio Desktop flows Modellgesteuerte Apps Power Platform CLI Dataverse Funktionen Power Pages

Konvertieren Sie zwischen hexadezimalen Textzeichenfolgen und Zahlen.

Beschreibung

Verwenden Sie die Dec2Hex Funktion, um eine Zahl in eine hexadezimale Textzeichenfolge zu konvertieren. Dec2Hex gibt die Zeichen 0 durch 9 und Großbuchstaben A durch F; verwenden Sie die Untere Funktion, um das Ergebnis bei Bedarf in Kleinbuchstaben zu konvertieren. Dec2Hex schneidet die Eingabenummer auf eine ganze Zahl ab, als ob die Funktion "Abschneiden " zuerst angewendet wurde. 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 Hex2Dec Funktion, um eine Textzeichenfolge mit hexadezimalen Ziffern (0 durch 9 und A durch F) in eine Zahl zu konvertieren. Es werden Groß- und Kleinbuchstaben akzeptiert. Maximal 10 Hexadezimalzeichen können an Hex2Decü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( Zahl [, Orte] )

  • Nummer - Erforderlich. In Hexadezimalzahl umzuwandelnde Zahl.
  • Orte – Optional. Die Anzahl der zu verwendenden Zeichen, wenn die Zahl positiv ist. Wenn "Orte " nicht angegeben wird, Dec2Hex wird die Mindestanzahl der erforderlichen Zeichen verwendet. Wenn dieser Parameter angegeben wird und das Ergebnis nicht in den bereitgestellten Platz passt, wird ein Fehler ErrorKind.Numeric zurückgegeben. Orte 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 Nutzung 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 Nutzung 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 des Dec2Hex Arguments "Orte"

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 mit Dec2Hex einspaltigen Tabellen und Argument "Orte"

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" ]