Перейти к основному содержимому

Byte.From

Создает 8-разрядное целое число, полученное из предоставленного значения.

Syntax

Byte.From(
value as any,
optional culture as text,
optional roundingMode as RoundingMode.Type
) as number

Remarks

Возвращает 8-разрядное целочисленное значение number, полученное из предоставленного значения value. Если данное value равно NULL, то Byte.From возвращает NULL. Если данное value представляет собой number в диапазоне 8-разрядных целых чисел и не имеет дробной части, то value и возвращается. При наличии дробной части число округляется в соответствии с указанным режимом. Режим округления по умолчанию — RoundingMode.ToEven. Если value имеет какой-либо другой тип, сначала выполняется преобразование в number с помощью Number.FromText. Доступные режимы округления см. в описании Number.Round. При необходимости можно также указать culture (например, "ru-RU").

Examples

Example #1

Получить 8-разрядное целое значение <code>number</code> для <code>"4"</code>.

Byte.From("4")

Result:

4

Example #2

Получить 8-разрядное целое значение <code>number</code> для <code>"4.5"</code>, используя <code>RoundingMode.AwayFromZero</code>.

Byte.From("4.5", null, RoundingMode.AwayFromZero)

Result:

5

Category

Number.Conversion and formatting