Функції Dec2Hex і Hex2Dec

Застосовується до: додатків Canvas Low-code Dataverse плагінів Потоки робочого стола Програми Power Platform CLI на основі моделі

Перетворення між шістнадцятковими текстовими рядками та числами.

Опис

Використовуйте функцію Dec2Hex, щоб перетворити число на шістнадцятковий текстовий рядок. Dec2Hex випромінює символи 09 наскрізь, A а символи верхнього регістру через F; за бажанням скористайтеся функцією Lower , щоб перетворити результат у нижній регістр. Dec2Hex обрізає вхідне число до цілого числа, наче спочатку було застосовано функцію Trunc . Використовуйте Places , щоб доповнити додатне число початковими 0s (нулями) і обмежити довжину виведення; Місця ігнорується, якщо вхідні дані від’ємні.

Використовуйте функцію Hex2Dec для перетворення текстового рядка, що містить шістнадцяткові цифри (0 наскрізь 9AF), на число. Приймаються символи верхнього та нижнього регістрів. У Hex2Dec можна передати не більше 10 шістнадцяткових символів.

Обидві ці функції працюють з 40-бітним, двійковим, цілим числом. Діапазон допустимих значень для обох функцій є шістнадцятковим 8000000000 або десятковим -549755813888 до шістнадцяткового 7FFFFFFFF або десяткового 549755813887.

Якщо передати цим функціям одне число або текстовий рядок, поверненим значенням буде один результат. Якщо передати таблицю з одним стовпцем, поверненим значенням буде таблиця результатів з одним стовпцем , по одному результату для кожного запису в таблиці аргументу. Якщо ваша таблиця має кілька стовпців, ви можете переробити її на таблицю з одним стовпцем, як описано в розділі Робота з таблицями.

Якщо вхідне значення виходить за межі діапазону або містить неприпустимі шістнадцяткові символи, повертається помилка ErrorKind.Numeric . Якщо вхідними даними була таблиця з одним стовпцем, помилка вбудовується в таблицю виведення.

Синтаксис

Dec2Hex( Кількість [, Місць] )

• Number — обов’язковий аргумент. Число для перетворення в шістнадцяткове.
• Місця - необов’язково . Кількість символів, які слід використовувати, якщо число додатне. Якщо параметр Місця пропущено, Dec2Hex використовує мінімальну кількість символів. Якщо цей параметр надано, а результат не вміщується у вказане місце, повертається помилка ErrorKind.Numeric . Місця буде проігноровано, якщо число, яке потрібно перетворити, є від’ємним.

Hex2Dec( Шістнадцятковий рядок )

• HexString - обов’язковий. Рядок шістнадцяткових цифр для перетворення в число.

Приклади

Основне використання Hex2Dec

Формула	Результат
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 ]

Основне використання Dec2Hex

Формула	Результат
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" ]

Основне використання Dec2Hex з аргументом Places

Формула	Результат
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)

Основне використання Dec2Hex з таблицями з одним стовпцем і аргументом Places

Формула	Результат
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" ]