Num — функция скриптa и диаграммы
Num() форматирует число, то есть преобразует числовое значение ввода в отображаемый текст, используя формат, указанный во втором параметре. Если второй параметр опущен, то используются десятичные и тысячные разделители, установленные в скрипте загрузки данных. Пользовательские символы разделителей десятичных разрядов и тысяч являются дополнительными параметрами.
Синтаксис:
Num(number[, format[, dec_sep [, thou_sep]]])
Возвращаемые типы данных: двойное значение
Функция Num возвращает двойное значение, которое включает строковое и числовое значения. Функция берет числовое значение входного выражения и создает строку, представляющую собой число.
Аргумент | Описание |
---|---|
number | Текстовая строка для оценки. |
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(35648.312) | Возвращает 35648.312 (зависит от переменных среды в скрипте) |
Num(35648.312, '0.0', '.') | Возвращает 35648.3 |
Num(35648.312, '0,00', ',') | Возвращает 3,56,48 |
Num(35648.312, '#,##0.0', '.', ',') | Возвращает 35,648.3 |
Num(35648.312, '# ##0', ',', ' ') | Возвращает 35 648 |