FormatNumber - Revision history

Admin: 1 revision imported

2021-11-20T17:07:19Z

1 revision imported

1>Admin at 08:00, 3 October 2021

2021-10-03T08:00:05Z

Admin: 1 revision imported

2021-02-07T06:51:00Z

1 revision imported

Admin at 14:48, 28 April 2019

2019-04-28T14:48:44Z

New page

{{infobox function
|name=FormatNumber
|caption=Функции работы со строками, числами
|type=1
|status=2
|db=0
|exception=Невозможно превратить в строку, число
|visual=0}}
{{HeadLinks|
* [[Main_Page|Начальная страница]]
* [[Общее_описание_языка|Общее описание]]
* [[Строковые функции]], [[Математические функции]]}}
Функция производит перекодировку и формирование числа в строковой формат, используя указанные установки. В отличие от функции [[NumberToStr]] имеет возможности, более подходящие для вывода числа в таблицы и на печать.

== Синтаксис ==
<code>
'''FormatNumber'''(''<Число>''{{Optional|,''<Нули пустой строкой (INT)>''{{Default|{{Eq}}1}}}}{{Optional|,''<Разделитель тысяч (STRING)>''{{Default|{{Eq}}"'"}}}}{{Optional|,''<Точность после точки (INT)>''{{Default|{{Eq}}2}}}}):''<Результат (STRING)>''
</code>
==== Аргументы ====
* <code>''<Число>''</code> - Аргумент, числовое представление которого необходимо перекодировать.
* <code>''<Нули пустой строкой (INT)>''</code> - {{Optional}} Форматирует случай, когда первый аргумент равен нулю. Если этот параметр равен нулю, результат будет представлен как <code>0</code>, иначе (по умолчанию) результат будет представлен пустой строкой.
* <code>''<Разделитель тысяч (STRING)>''</code> - {{Optional}} Задает символ или комбинацию символов, которая будет использоваться для разделения разрядов тысяч. Если разделитесь не требуется, необходимо использовать для этого аргумента пустую строку. По умолчанию, используется символ апострофа (<code>'</code>). К примеру, число 1234567.89 будет отформатировано с разделителем по умолчанию, как <code>1'234'567.89</code>
* <code>''<Точность после точки (INT)>''</code> - {{Optional}} Округление числа до указанного количества знаков до или после точки, см. [[Round]]. По умолчанию этот параметр равен 2, что больше подходит для денежных номинаций.

==== Возвращаемое значение ====
Функция всегда возвращает строку UTF-16. Если число достаточно велико, мало или близко к нулю, используется инженерная нотация для результата (с мантиссой '''E''') и разделители тысяч не подставляются.

== Примеры ==
<pre>
Message(FormatNumber(1234567.891234567));
//Будет выведено "1'234'567.89"

Message(FormatNumber(1234567.891234567,," ",4));
//Будет выведено "1 234 567.8912"

Message(FormatNumber(1234567.891234567,,"",-3));
//Будет выведено "1235000"

Message(FormatNumber(0));
//Будет выведено ""
</pre>

← Older revision	Revision as of 17:07, 20 November 2021
(No difference)

@@ Line 21: / Line 21: @@
 * <code>''<Нули пустой строкой (INT)>''</code> - {{Optional}} Форматирует случай, когда первый аргумент равен нулю. Если этот параметр равен нулю, результат будет представлен как <code>0</code>, иначе (по умолчанию) результат будет представлен пустой строкой.
 * <code>''<Разделитель тысяч (STRING)>''</code> - {{Optional}} Задает символ или комбинацию символов, которая будет использоваться для разделения разрядов тысяч. Если разделитесь не требуется, необходимо использовать для этого аргумента пустую строку. По умолчанию, используется символ апострофа (<code>'</code>). К примеру, число 1234567.89 будет отформатировано с разделителем по умолчанию, как <code>1'234'567.89</code>
-* <code>''<Точность после точки (INT)>''</code> - {{Optional}} Округление числа до указанного количества знаков до или после точки, см. [[Round]]. По умолчанию этот параметр равен 2, что больше подходит для денежных номинаций.
+* <code>''<Точность после точки (INT)>''</code> - {{Optional}} Округление числа до указанного количества знаков до или после точки, см. [[Round]]. По умолчанию этот параметр равен 2, что больше подходит для денежных номинаций. Если количество цифр после десятичной точки меньше указанной точности, результат будет дополнен нулями.
 ==== Возвращаемое значение ====
@@ Line 31: / Line 31: @@
 //Будет выведено "1'234'567.89"
-Message(FormatNumber(1234567.891234567,," ",4));
+Message(FormatNumber(1234567.891,," ",4));
-//Будет выведено "1 234 567.8912"
+//Будет выведено "1 234 567.8910"
 Message(FormatNumber(1234567.891234567,,"",-3));

← Older revision	Revision as of 06:51, 7 February 2021
(No difference)