Num() интерпретирует текстовую строку как числовое значение, то есть преобразует входную строку в число, используя формат, указанный во втором параметре. Если второй параметр опущен, то используются десятичные и тысячные разделители, установленные в скрипте загрузки данных. Пользовательские символы разделителей десятичных разрядов и тысяч являются дополнительными параметрами.
Синтаксис:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])
Возвращаемые типы данных: двойное значение
Функция Num#() возвращает двойное значение, которое включает строковое и числовое значения. Функция берет текстовое представление входного выражения и создает число. Формат числа не изменяется; выходное число форматируется так же, как и входное.
Аргументы:
| Аргумент | Описание |
|---|---|
| text | Текстовая строка для оценки. |
| format |
Строка, указывающая формат числа, используемый в первом параметре. Если не указано, то используются десятичные и тысячные разделители, установленные в скрипте загрузки данных. |
| dec_sep |
Строка, определяющая десятичный разделитель. Если не указано, используется значение переменной DecimalSep, установленной в скрипте загрузки данных. |
| thou_sep |
Строка, определяющая разделитель тысяч. Если не указано, используется значение переменной ThousandSep, установленной в скрипте загрузки данных. |
В следующей таблице показан результат Num#( A, '#', '.' , ',') для различных значений A.
| Пример | Результат (строка) | Результат (число) |
|---|---|---|
| Num#( '35,648.31', '#', '.' , ',' ) | 35,648.31 | 35648.31 |
| Num#( ‘35 648.312’, '#', '.' , ',' ) | 35 648.312 | 35648.312 |
| Num#( '35.648,3123', '#', '.' , ',' ) | 35.648,3123 | - |
| Num#( '35 648,31234', '#', '.' , ',' ) | 35 648,31234 | - |
| Num#('1,234.56', '#,##0.00') | 1,234.56 | 1234.56 |
| Num#('$1,230.45', '$#,##0.00') | $1,230.45 | 1230.45 |
| Num#('20220315', 'YYYYMMDD') | 20220315 | 20220315 |