# Num — скрипт и функция диаграммы

Num() форматирует число, то есть преобразует входное числовое значение для отображения текста в формате, заданном вторым параметром. Если второй параметр опущен, то используются десятичные разделители и разделители тысяч, заданные в скрипте загрузки данных. Пользовательские символы разделителей десятков и тысяч являются дополнительными параметрами.

Синтаксис:

Num(number[, format[, dec\_sep [, thou\_sep]]])

Возвращаемые типы данных: двойное значение

Функция Num возвращает двойное значение, содержащее строку и числовое значение. Эта функция принимает числовое значение входного выражения и создает строку, представляющую число.

Аргументы:

аргументы Num

| Аргумент | Описание |
| --- | --- |
| number | Число для изменения формата. |
| format | Строка, описывающая, как будет отформатирована полученная строка. Если не указано, то используются десятичные разделители и разделители тысяч, заданные в скрипте загрузки данных. |
| dec\_sep | Строка, определяющая десятичный разделитель. Если не указано, в скрипте загрузки данных используется значение переменной DecimalSep. |
| thou\_sep | Строка, определяющая разделитель тысяч. Если не указано, в скрипте загрузки данных используется значение переменной ThousandSep. |

Пример:

В следующей таблице приводятся результаты, когда значение в поле A равно 35648,312.

Результаты

| A | Результат |
| --- | --- |
| Num(A) | 35648.312 (в зависимости от переменных среды в скрипте) |
| Num(A, '0.0', '.') | 35648.3 |
| Num(A, '0,00', ',') | 35648,31 |
| Num(A, '#,##0.0', '.', ',') | 35,648.3 |
| Num(A, '# ##0', ',', ' ') | 35 648 |

Пример:

Добавьте пример скрипта в приложение и запустите.

Затем создайте прямую таблицу с полями `Field1` и `Field2` в качестве измерений.

`Sheet1:` `let result= Num( pi( ), '0,00' );` `Load * inline` `[Field1; Field2` `9; 8,2` `1; $(result)` `](delimiter is ';');` ` `

` Field1  `содержит значения 1 и 9.

` Field2  `содержит значения 3,14 и 8,2.