Dec2Hex і Hex2Dec функції

Застосовується до: Програми Canvas Copilot Studio Desktop flows Model-driven apps Power Platform CLI Dataverse functions Power Pages

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

Опис

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

Hex2Dec За допомогою функції можна перетворити текстовий рядок із шістнадцятковими цифрами (0через 9 і A черезF) на число. Приймаються символи верхнього та нижнього регістру. Не більше 10 шістнадцяткових символів можна передати до Hex2Dec.

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

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

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

Синтаксис

Dec2Hex( Число [, місця] )

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

Hex2Dec( HexString )

• 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 з аргументом "Місця"

Формула	Результат
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 з таблицями з одним стовпцем і аргументом "Місця"

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