Цифра прописью

Формат (Format)
Синтаксис:
Формат(<Значение>, <Форматная строка>)
Параметры:
<Значение> (обязательный)
Тип: Число, Дата, Булево. Форматируемое значение.
<Форматная строка> (необязательный)
Тип: Строка. Форматная строка представляет собой строковое значение, включающее параметры форматирования.
Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (0 и 01.01.0001 00:00:00 соответственно) будет выдаваться пустая строка.
Параметры форматирования перечисляются через символ ";". Наличие параметра означает отличие форматирования от стандартного. Если параметр не указывается, используется стандартное форматирование. Оно в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата для значений этих типов по умолчанию (0 и 01.01.0001 00:00:00, соответственно) будет выдаваться пустая строка.
Каждый параметр задается именем параметра, символом "=" и значением параметра. Значение параметра может указываться в одинарных или двойных кавычках. Это необходимо, если значение параметра содержит символы, используемые в синтаксисе форматной строки. Внутри значения параметра могут указываться произвольные символы, которые при формировании результирующей строки будут отображаться как есть. Таким образом, например, можно указывать разделители часов, минут и секунд при форматировании времени. Если эти символы совпадают со значениями форматной строки их необходимо заключать в одинарные кавычки.
Имена и значения параметров форматной строки:
Л (L) - Имя языка, страны, для которых будет выполняться стандартное форматирование. Доступные имена языков:
af_ZA - Африкаанс (Южная Африка);
be_BY - Белорусский (Белоруссия);
bg_BG - Болгарский (Болгария);
ca_ES - Каталонский (Испания);
cs_CZ - Чешский (Чехия);
da_DK - Датский (Дания);
de_AT - Немецкий (Австрия);
de_CH - Немецкий (Швейцария);
de_DE - Немецкий (Германия);
de_LI - Немецкий (Лихтенштейн);
de_LU - Немецкий (Люксембург);
el_GR - Греческий (Греция);
en_AU - Английский (Австралия);
en_BZ - Английский (Белиз);
en_CA - Английский (Канада);
en_GB - Английский (Великобритания);
en_IE - Английский (Ирландия);
en_JM - Английский (Ямайка);
en_NZ - Английский (Новая Зеландия);
en_PH - Английский (Филиппины);
en_TT - Английский (Тринидад и Тобаго);
en_US - Английский (США);
en_ZA - Английский (Южная Африка);
en_ZW - Английский (Зимбабве);
es_AR - Испанский (Аргентина);
es_BO - Испанский (Боливия);
es_CL - Испанский (Чили);
es_CO - Испанский (Колумбия);
es_CR - Испанский (Коста-Рика);
es_DO - Испанский (Доминиканская республика);
es_EC - Испанский (Эквадор);
es_ES - Испанский (Испания);
es_ES_Tr - Испанский (Испания, традиционная сортировка);
es_GT - Испанский (Гватемала);
es_HN - Испанский (Гондурас);
es_MX - Испанский (Мексика);
es_NI - Испанский (Никарагуа);
es_PA - Испанский (Панама);
es_PE - Испанский (Перу);
es_PR - Испанский (Пуэрто-Рико);
es_PY - Испанский (Парагвай);
es_SV - Испанский (Сальвадор);
es_UY - Испанский (Уругвай);
es_VE - Испанский (Венесуэла);
et_EE - Эстонский (Эстония);
eu_ES - Баскский (Испания);
fi_FI - Финский (Финляндия);
fo_FO - Фарерский (Фарерские острова);
fr_BE - Французский (Бельгия);
fr_CA - Французский (Канада);
fr_CH - Французский (Швейцария);
fr_FR - Французский (Франция);
fr_LU - Французский (Люксембург);
fr_MC - Французский (Монако);
hr_HR - Хорватский (Хорватия);
hu_HU - Венгерский (Венгрия);
id_ID - Индонезийский (Индонезия);
is_IS - Исландский (Исландия);
it_CH - Итальянский (Швейцария);
it_IT - Итальянский (Италия);
kk_KZ - Казахский (Казахстан);
lt_LT - Литовский (Литва);
lv_LV - Латышский (Латвия);
nl_BE - Голландский (Бельгия);
nl_NL - Голландский (Нидерланды);
nb_NO - Норвежский (Bokmal) (Норвегия);
nn_NO - Норвежский (Nynorsk) (Норвегия);
pl_PL - Польский (Польша);
pt_BR - Португальский (Бразилия);
pt_PT - Португальский (Португалия);
ro_RO - Румынский (Румыния);
ru_RU - Русский (Россия);
sk_SK - Словацкий (Словакия);
sl_SI - Словенский (Словения);
sq_AL - Албанский (Албания);
sr_SP_Cy - Сербский (кириллица) (Сербия);
sr_SP_Lt - Сербский (латиница) (Сербия);
sv_FI - Шведский (Финляндия);
sv_SE - Шведский (Швеция);
tr_TR - Турецкий (Турция);
uk_UA - Украинский (Украина).
ЧЦ (ND) - Общее число отображаемых десятичных разрядов целой и дробной частей. Исходное число округляется при этом в соответствии с правилами округления, заданными для конфигурации. Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.
ЧДЦ (NFD) - Число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилами округления, заданными для конфигурации.
ЧС (NS) - Сдвиг разрядов: положительный - деление, отрицательный - умножение. Другими словами, это означает, что исходное число будет умножено или поделено на 10*С, где С - значение параметра по модулю.
ЧРД (NDS) - Символ-разделитель целой и дробной части.
ЧРГ (NGS) - Символ-разделитель групп целой части числа.
ЧН (NZ) - Строка, представляющая нулевое значение числа. Если не задано, то представление в виде пустой строки. Если задано "ЧН=", то в виде "0". Не используется для числовых полей ввода.
ЧВН (NLZ) - Нужно ли выводить лидирующие нули. Значение данного параметра не задается, собственно наличие параметра определяет вывод лидирующих нулей.
ЧГ (NG) - Порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Чтобы указать, что последнее число группировки должно повторяться для всех старших разрядов, то после него через запятую указывается 0.
ЧО (NN) - Представление отрицательных чисел.
0 - строка вида "(1,1)";
1 - строка вида "-1,1";
2 - строка вида "- 1,1";
3 - строка вида "1,1-";
4 - строка вида "1,1 -".
ДФ (DF) - Формат даты.
д (d) - день месяца (цифрами) без лидирующего нуля;
дд (dd) - день месяца (цифрами) с лидирующим нулем;
ддд (ddd) - краткое название дня недели *);
дддд (dddd) - полное название дня недели *);
М (M) - номер месяца (цифрами) без лидирующего нуля;
ММ (MM) - номер месяца (цифрами) с лидирующим нулем;
МММ (MMM) - краткое название месяца *);
ММММ (MMMM) - полное название месяца *);
к (q) - номер квартала в году;
г (y) - номер года без века и лидирующего нуля;
гг (yy) - номер года без века с лидирующим нулем;
гггг (yyyy) - номер года с веком;
ч (h) - час в 12 часовом варианте без лидирующих нулей;
чч (hh) - час в 12 часовом варианте с лидирующим нулем;
Ч (H) - час в 24 часовом варианте без лидирующих нулей;
ЧЧ (HH) - час в 24 часовом варианте с лидирующим нулем;
м (m) - минута без лидирующего нуля;
мм (mm) - минута с лидирующим нулем;
с (s) - секунда без лидирующего нуля;
сс (ss) - секунда с лидирующим нулем;
tt (tt) - отображение половины дня AM/PM (действительно только для языков конфигурирования, поддерживающих 12 часовой вариант представления времени).
Примечание: *) - не используется для форматной строки поля ввода даты.
ДЛФ (DLF) - Локальный формат даты. Указывается вариант отображения частей даты.
Д (D) - дата (цифрами);
ДД (DD) - длинная дата (месяц прописью);
В (T) - полное время, дата может объединяться со временем.
Пример: выражение Формат('20051120140323',"ДЛФ=ДДВ") имеет значение "20 ноября 2005 г. 14:03:23".
Важно! Порядок следования опций форматной строки для ДЛФ <дата + время> (ДВ или ДДВ) не может быть изменен.
ДП (DE) - Строка, представляющая пустую дату (например, Формат('00010101000000' ,"ДП=пустая дата") вернет строку "пустая дата").
БЛ (BF) - Строка, представляющая логическое значение Ложь.
БИ (BT) - Строка, представляющая логическое значение Истина.
Примечание. Использование параметров для поля ввода: параметр ДП (DE) не используется; параметр ДЛФ (DLF) используется только со значениями Д (D), В(T) и ДВ (DT).
Возвращаемое значение:
Тип: Строка. Строка, полученная в результате форматирования переданного значения.
Описание:
Формирует удобное для чтения представление значений. Полезно использование в отчетах и при прочем визуальном отображении значений.
Пример:
// Примеры форматирования чисел
А = Формат(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";

// Примеры форматирования логических выражений
А = Формат(Истина, "БЛ=Отсутствует; БИ=Доступен");
// А = "Доступен";