Функции форматирования
Синтаксис:
Формат(<Значение> , <Форматная строка>)
Параметры:
<3начение> - Обязательный
Тип: Число, Дата, Булево. Форматируемое значение.
<Форматная строка> - Необязательный
Тип: Строка. Форматная строка представляет собой строковое значение, включающее параметры форматирования. Параметры форматирования перечисляются через символ ";". Наличие параметра означает отличие форматирования от стандартного. Если параметр не указывается, используется стандартное форматирование.
Каждый параметр задается именем параметра, символом "=" и значением параметра. Значение параметра может указываться в одинарных или двойных кавычках. Это необходимо, если значение параметра содержит символы, используемые в синтаксисе форматной строки. Внутри значения параметра могут указываться произвольные символы, которые при формировании результирующей строки будут отображаться как есть. Таким образом, например, можно указывать разделители часов, минут и секунд при форматировании времени. Если эти символы совпадают с значениями форматной строки их необходимо заключать в одинарные кавычки.
Имена и значения параметров форматной строки:
• Л (L) - Имя языка, страны, для которых будет выполняться стандартное форматирование.
Доступные имена языков:
be_BY - Белорусский (Белоруссия);
de_DE - Немецкий (Германия);
de_LI - Немецкий (Лихтенштейн);
en_GB - Английский (Великобритания);
en_US - Английский (США);
en_ZA - Английский (Южная Африка);
es_ES_MO - Испанский (Испания, современная сортировка);
es_ES_TR - Испанский (Испания, традиционная сортировка);
fi_FI - Финский (Финляндия);
fr_FR - Французский (Франция);
it_IT - Итальянский (Италия);
ru_RU - Русский (Россия);
uk_UA - Украинский (Украина).
• ЧЦ (ND) - Общее число отображаемых десятичных разрядов целой части. Исходное число округляется при этом в соответствии с правилами округления, заданными для конфигурации. Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.
• ЧДЦ (NFD) - Число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилами округления, заданными для конфигурации.
• ЧС (NS) - Сдвиг разрядов: положительный - деление, отрицательный - умножение. Другими словами, это означает, что исходное число будет умножено или поделено на 10*С, где С - значение параметра по модулю.
• ЧРД (NDS) - Символ-разделитель целой и дробной части.
• ЧРГ (NGS) - Символ-разделитель групп целой части числа.
• ЧН (NZ) - Строка, представляющая нулевое значение числа.
• ЧВН (NLZ) - Нужно ли выводить лидирующие нули. Значение данного параметра не задается, собственно наличие параметра определяет вывод лидирующих нулей.
• ЧГ (NG) - Порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Чтобы указать, что последнее число группировки должно повторяться для всех старших разрядов, то после него через запятую указывается 0.
• ЧО (NN) - Представление отрицательных чисел.
0 - строка вида "(1,1)";
1 - строка вида "-1,1";
2 - строка вида "- 1,1";
3 - строка вида "1,1-";
4 - строка вида "1,1 -".
• ДФ (DP) - Формат даты.
• д (d) - день месяца (цифрами) без лидирующего нуля;
• дд (dd) - день месяца (цифрами) с лидирующим нулем;
• ддд (ddd) - краткое название дня недели;
• дддд (dddd) - полное название дня недели;
• М (М) - номер месяца (цифрами) без лидирующего нуля;
• MM (MM) - номер месяца (цифрами) с лидирующим нулем;
• МММ (МММ) - краткое название месяца;
• ММММ (ММММ) - полное название месяца;
• к(q) - номер квартала в году;
• г (у) - номер года без века и лидирующего нуля;
• гг (уу) - номер года без века с лидирующим нулем;
• гггг (уууу) - номер года с веком;
• ч (h) - час в 12 часовом варианте без лидирующих нулей;
• чч (hh) - час в 12 часовом варианте с лидирующим нулем;
• Ч (H) - час в 24 часовом варианте без лидирующих нулей;
• ЧЧ (HH) - час в 24 часовом варианте с лидирующим нулем;
• м (m) - минута без лидирующего нуля;
• мм (mm) - минута с лидирующим нулем;
• с (s) - секунда без лидирующего нуля;
• сс (ss) - секунда с лидирующим нулем;
• tt - отображение половины дня АМ/РМ ( действительно только для языков поддерживающих 12 часовой вариант представления времени).
• ДЛФ (DLF) - Локальный формат даты. Указывается вариант отображения частей даты.
• Д (D) - дата;
• ДД (DD) - длинная дата;
• В (Т) - время, дата может объединяться со временем.
• ДП (DE) - Строка, представляющая пустую дату '00010101000000'.
• БЛ (BF) - Строка, представляющая логическое значение Ложь.
• БИ (ВТ) - Строка, представляющая логическое значение Истина.
Для параметров определяющих отображение нулевого числа и даты '00010101000000' наличие параметра без конкретного значение означает использование стандартного преобразования числа и даты к строке.
Значение по умолчанию: Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (0 и 01.01.0001 00:00:00 соответственно) будет выдаваться пустая строка.
Возвращаемое значение:
Тип: Строка. Строка, полученная в результате форматирования переданного значения.
Описание:
Позволяет сформировать читабельное представление значений. Полезно использование в отчетах и при прочем визуальном отображении значений.
Пример:
// Примеры форматирования чисел
А = Формат(123456.789, "ЧЦ=10; ЧДЦ=2">; // А = "123 456,79"
А = Формат(123456.789, "ЧРД=--"); // А = "-123 456-789"
А = Формат(-123456.789, "ЧО=0"); // А = "(123 456,789)"
// Примеры форматирования дат
А = Формат('20020820153309', "ДФ="ДД ММММ ГГГГ Т.' ЧЧ:ММ:СС'"") ;
// А = 20 августа 2002 г. .15:33:09"
А = Формат('20020820153309', "ДФ=" "дд/ММ-ггрг"") ;
// А = 20/08-2002"
А = Формат('20020820153309', "ДЛФ=ДД");
// А = 20 августа 2002 г.";
А = Формат( 20020820153309', "ДЛФ=Д");
// А = 20.08.2002";
А = Формат; 20020820153309', "ДЛФ=В");
// А = 15:33:09";
// Примеры форматирования логических выражений
А = Формат(Истина, "БЛ=Нет; БИ=Есть");
// А = "Есть"
| «««««««««« | 1С:Предприятие 8.0 | »»»»»»»»»» |
