Contents
Index 🔎︎

# Format Function

Преобразует число в строку и затем форматирует её согласно указанному формату.

## Синтаксис

    Format (Число [, Формат As String])

## Возвращаемое значение:

String

## Параметры:

Число. Число, которое должно быть преобразовано в форматированную строку.

Формат. Строка, указывающая код формата для данного числа. Если параметр Формат опущен, функция Format работает как функция Str.

## Коды форматирования

Ниже перечислены коды, которые можно использовать для форматирования числа.

0:. Если параметр Число имеет цифру в позиции 0 в коде формата, отображается эта цифра; иначе отображается ноль.

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

Десятичные разряды числа округляются до количества нулей в коде Формат после десятичного разделителя.

#:. Если параметр Число содержит цифру в позиции местозаполнителя # в коде Формат, отображается эта цифра; в любом другом случае в этой позиции ничего не отображается.

Этот символ работает как 0, за исключением того, что заполняющие нули (слева или справа) не отображаются, когда в коде формата имеется больше символов #, чем цифр в этом числе. Отображаются только необходимые цифры в этом числе.

.. Десятичный местозаполнитель определяет количество десятичных разрядов слева и справа от десятичного разделителя.

Если код формата содержит только местозаполнители # слева от этого символа, числа меньше 1 начинаются с десятичного разделителя. Чтобы всегда показывать начальный ноль с дробными числами, используйте 0 как местозаполнитель для первой цифры слева от десятичного разделителя.

%. Число умножается на 100. Знак процента (%) вставляется в той позиции, где число появляется в коде формата.

E- E+ e- e+. Если код формата содержит хотя бы один местозаполнитель разряда (0 или #) справа от символа E-, E+, e-, или e+, такое число форматируется в экспоненциальном формате. Буква Е или е вставляется между этим числом и экспонентой. Количество местозаполнителей для разрядов справа от этого символа определяет количество разрядов в экспоненте.

Если экспонента является отрицательной, знак минус отображается непосредственно перед экспонентой с E-, E+, e-, e+. Если экспонента является положительной, знак плюс отображается только перед экспонентами с Е+ или е+.

Разделитель тысяч отображается в том случае, если код формата содержит разделитель, окруженный местозаполнителями разрядов (0 или #).

Использование точки как разделителя групп разрядов или десятичного разделителя определяется параметрами региональных стандартов операционной системы. При вводе числа непосредственно в исходный код Basic всегда используйте в качестве десятичного разделителя точку. Фактически отображаемый в качестве десятичного разделителя символ определяется форматом чисел, заданным в системных параметрах.

- + $ ( ) пробел. Плюс (+), минус (-), доллар ($), пробел или скобки, расположенные непосредственно в коде формата, отображаются как символы.

Чтобы показать другие символы, необходимо предварить их обратной косой чертой (\) или заключить в кавычки (" ").

\. Обратная косая черта показывает следующий символ в коде формата.

Символы в коде формата, которые имеют специальное значение, могут быть отображены как символы только в том случае, если они предваряются обратной косой чертой. Сама обратная косая черта не отображается, если двойная обратная косая черта (\\) не введена в коде формата.

Элементы, которые должны предваряться обратной косой чертой в коде формата для того, чтобы они отображались как символы, - это символы для форматирования даты и времени (a, c, d, h, m, n, p, q, s, t, w, y, /, :), символы для числового форматирования (#, 0, %, E, e, запятая, точка) и символы для форматирования строк (@, &, <, >, !).

Можно также использовать следующие предопределенные числовые форматы. За исключением "General Number", все предопределенные коды формата возвращают число как десятичное с двумя десятичными разрядами.

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

## Предопределенный формат

General Number. Числа отображаются так, как они введены.

Currency. Знак рубля помещается за числом, отрицательные числа заключаются в скобки.

Fixed. По крайней мере один разряд показывается перед десятичным разделителем.

Standard. Числа отображаются с разделителем групп разрядов.

Percent:. Число умножается на 100, и к этому числу добавляется знак процента.

Scientific. Числа отображаются в научном формате (например, 1,00E+03 для числа 1000).

Код формата можно разделить на три части, отделенные точками с запятой. Первая часть определяет формат для положительных значений, вторая часть - для отрицательных, а третья часть - для нулевых. Если задан только один код формата, он применяется ко всем числам.

Языковые параметры, используемые для управления форматированием чисел, дат и валют, устанавливаются в меню LibreOffice Basic LibreOffice - ПараметрыСервис - Параметры - Настройки языка - Языки. В кодах формата Basic десятичная точка (.) всегда выполняет роль заполнителя для десятичного разделителя, определенного в национальной настройке, и будет заменена соответствующим символом.

То же самое относится и к параметрам языка для форматов даты, времени и валюты. Код формата Basic будет интерпретироваться и отображаться в соответствии с определенным пользователем языком.

## Error codes:

5 Неправильный вызов процедуры

## Пример:

    Sub ExampleFormat
        MsgBox Format(6328.2, "##,##0.00")
        REM как разделитель разрядов всегда используется точка, если числа вводятся в исходном коде Basic.
        REM отображает, например, 6,328.20 для английского языка, 6.328,20 для немецкого языка.
    End Sub

См. также

Number format codes