num

Назначение

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

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

Эта функция относится к функциям приведения, меняющим тип значения.

Синтаксис

num(строка)

Аргументы

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

Для различения символов в зависимости от региональных настроек, функция поддерживает именованный параметр "language", который может принимать одно из следующих значений:

  • "en", "eng", "English", "English (United States)" для английского языка (\',' для разделителя тысяч, \'.' для десятичного знака, и т.д.);

  • "ru", "rus", "Russian" для русского языка (' ' для разделителя тысяч, \',' для десятичного знака, и т.д…​);

  • "cht", "Chinese-Traditional" для китайского языка с традиционным письмом (' ' для разделителя тысяч, \',' для десятичного знака, и т.д.);

  • "chs", "Chinese" для китайского языка с упрощенным письмом (' ' для разделителя тысяч, \',' для десятичного знака, и т.д.)

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

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

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

Примеры

Выражение

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

num ("1234")

1234.0

num ("6.08")

6.08