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

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.

Пример. Основы использования функции Num#

Пример. Сценарий использования функции Num#

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице и с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом, чтобы мы смогли ее исправить!