Num# — функция скриптa и диаграммы
Num() интерпретирует текстовую строку как числовое значение, то есть преобразует входную строку в число, используя формат, указанный во втором параметре. Если второй параметр опущен, то используются десятичные и тысячные разделители, установленные в скрипте загрузки данных. Пользовательские символы разделителей десятичных разрядов и тысяч являются дополнительными параметрами.
Синтаксис:
Num#(text[, format[, dec_sep [, thou_sep ] ] ])
Возвращаемые типы данных: двойное значение
Функция Num#() возвращает двойное значение, которое включает строковое и числовое значения. Функция берет текстовое представление входного выражения и создает число. Формат числа не изменяется; выходное число форматируется так же, как и входное.
Аргумент | Описание |
---|---|
text | Текстовая строка для оценки. |
format | Строка, указывающая формат числа, используемый в первом параметре. Если не указано, то используются десятичные и тысячные разделители, установленные в скрипте загрузки данных. Функция Num# поддерживает много вариантов формата для различных числовых структур, например: #,##0:отображает число без десятичных знаков. #,##0.00:отображает число с двумя десятичными знаками. ##0.00%:отображает число как процент с двумя десятичными знаками. #,##0;(#,##0): форматирует отрицательные значения, заключая их в круглые скобки. $#,##0.00: форматирует числа в виде денежной суммы с символом $. 0.00E+0: отображает числа в научной системе счисления. |
dec_sep | Строка, определяющая десятичный разделитель. Если не указано, используется значение переменной DecimalSep, установленной в скрипте загрузки данных. Функция Num# поддерживает много форматов разделителя десятичной дроби, например: Запятая «,»: например, $1,000,00 для одной тысячи долларов. Точка «.»: например, € 1,000.00. Дефис «-»: когда используется вместо традиционной точки или запятой в качестве десятичного разделителя, отображается как ¥1,000-00. Для получения дополнительной информации см. раздел DecimalSep. |
thou_sep | Строка, определяющая разделитель тысяч. Если не указано, используется значение переменной ThousandSep, установленной в скрипте загрузки данных. Функция Num# поддерживает много вариантов разделителя разряда тысяч: Точка «.»: точка используется в качестве разделителя тысяч (распространено в некоторых европейских форматах), отображается как $1.000,00 в сочетании с запятой в качестве десятичного разделителя. Пробел « »: пробел используется в качестве для разделителя тысяч, что распространено в некоторых европейских странах. Отображается как € 1 000.00. Подчеркивание «_»: подчеркивание используется в качестве разделителя тысяч, который иногда используется в технических или специфических региональных форматах. Отображается как $1_000.00. Для получения дополнительной информации см. раздел ThousandSep. |
Пример | Результаты (возвращаемое строковое значение) |
---|---|
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 и числовое значение NULL (-). |
Num#( '35 648,31234', '#', '.' , ',' ) | Возвращает строку 35 648,31234 и числовое значение NULL (-). |
Num#('1,234.56', '#,##0.00') | Возвращает строку 1,234.56 и числовое значение 1230.45. |
Num#('$1,230.45', '$#,##0.00') | Возвращает строку $1,230.45 и числовое значение 1234.56. |
Num#('20220315', 'YYYYMMDD') | Возвращает строку 20220315 и числовое значение 20220315. |