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

Int64.From

Создает 64-разрядное целое значение из данного значения.

Syntax

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

Remarks

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

Examples

Example #1

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

Int64.From("4")

Result:

4

Example #2

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

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

Result:

5

Category

Number.Conversion and formatting