num

Назначение

Функция num конвертирует строковое или текстовое значение в числовое.

Функция num может быть полезной в тех случаях, когда число было импортировано из внешнего источника данных в виде строки или текста, или если значение создавалось как строка, но ее нужно распарсить как число, чтобы применять по отношению к ней числовые операции.

Синтаксис

num(значение)

Аргументы

Функция num требует наличия одного аргумента, который должен быть булевого, строкового типа или типа данных "дата/время"; функция также принимает типы данных функций int и cat.

Функция также поддерживает некоторые именованные параметры:

  • строковые именованные параметры:

    • decimal_point

    • nan_name

    • thousands_separator

Возвращаемое значение

Функция возвращает числовое значение.

Если входное значение относится к типу "дата/время", то функция возвращает число, целая часть которого - количество дней с 1 января 1970 г., а дробная часть зависит от времени конечной даты.

Если исходное значение нулевое, возвращается нулевое значение. Если парсинг исходного значения невозможно выполнить в связи с тем, что исходное значение не содержит числа в нужном формате, возвращается нулевое значение.

Примеры

Выражение

Возвращаемое значение

num("12/500-6",thousands_separator:="/",decimal_point:="-")

12500.6

num("123,008.32421",language:="en")

123008.32421

num("34,2565,75,665",digits_grouping:="12,34,56,789")

34256575665.0

num ("1234")

1234.0

num ("6.08")

6.08

num(makedate(2006,1,2,12,30,30))

13,150.52