Контакты

Форматная строка. Форматная строка 1с формат редактирования

Параметры:

<Значение>

Форматируемое значение.

<ФорматнаяСтрока>

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

Параметры форматирования перечисляются через символ ";". Наличие параметра означает отличие форматирования от стандартного.

Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (0 и 01.01.0001 00:00:00 соответственно) будет выдаваться пустая строка.

Каждый параметр задается именем параметра, символом "=" и значением параметра. Значение параметра может указываться в одинарных или двойных кавычках. Это необходимо, если значение параметра содержит символы, используемые в синтаксисе форматной строки.

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

Имена и значения параметров форматной строки:

  • Л - имя языка, страны, для которых будет выполняться стандартное форматирование.
  • ЧЦ - общее число отображаемых десятичных разрядов целой и дробной частей. Исходное число округляется при этом в соответствии с правилами округления. Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.
  • ЧДЦ - число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилами округления.
  • ЧС - сдвиг разрядов: положительный - деление, отрицательный - умножение. Другими словами, это означает, что исходное число будет умножено или поделено на 10*С, где С - значение параметра по модулю.
  • ЧРД - символ-разделитель целой и дробной части.
  • ЧРГ - символ-разделитель групп целой части числа. Если в качестве разделителя использовать пустую строку, то в этом случае разделителем будет символ неразрывного пробела.
  • ЧН - строка, представляющая нулевое значение числа. Если не задано, то представление в виде пустой строки. Если задано "ЧН=", то в виде "0". Не используется для числовых полей ввода.
  • ЧВН - нужно ли выводить лидирующие нули. Значение данного параметра не задается, собственно наличие параметра определяет вывод лидирующих нулей.
  • ЧГ - порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Имеют смысл только два первых числа. Первое из них указывает первичную группировку, то есть ту, которая будет использована для наименее значимых разрядов целой части числа. Если второе число не указано, то будут сгруппированы только наименее значимые разряды. Если в качестве второго числа задан 0, то для всех разрядов целой части числа будет применено значение указанное для первичной группировки. Если в качестве второго числа используется значение, отличное от 0, то это значение будет использовано для группировки всех разрядов, кроме уже сгруппированных наименее значимых.
  • ЧО - представление отрицательных чисел.
    • 0 (0) - строка вида "(1,1)";
    • 1 (1) - строка вида "-1,1";
    • 2 (2) - строка вида "- 1,1";
    • 3 (3) - строка вида "1,1-";
    • 4 (4) - строка вида "1,1 -".
  • ДФ - формат даты.
    • д - день месяца (цифрами) без лидирующего нуля;
    • дд - день месяца (цифрами) с лидирующим нулем;
    • ддд - краткое название дня недели;
    • дддд- полное название дня недели;
    • М - номер месяца (цифрами) без лидирующего нуля;
    • ММ - номер месяца (цифрами) с лидирующим нулем;
    • МММ - краткое название месяца;
    • ММММ - полное название месяца;
    • к - номер квартала в году;
    • г - номер года без века и лидирующего нуля;
    • гг - номер года без века с лидирующим нулем;
    • гггг - номер года с веком;
    • ч - час в 12 часовом варианте без лидирующих нулей;
    • чч - час в 12 часовом варианте с лидирующим нулем;
    • Ч - час в 24 часовом варианте без лидирующих нулей;
    • ЧЧ (HH) - час в 24 часовом варианте с лидирующим нулем;
    • м - минута без лидирующего нуля;
    • мм - минута с лидирующим нулем;
    • с - секунда без лидирующего нуля;
    • сс - секунда с лидирующим нулем;
    • вв - отображение половины дня AM/PM (действительно только для языков конфигурирования, поддерживающих 12 часовой вариант представления времени).
  • ДЛФ - локальный формат даты. Указывается вариант отображения частей даты.
    • Д - дата (цифрами);
    • ДД - длинная дата (месяц прописью);
    • В - полное время, дата может объединяться со временем;
    • ДВ - дата время.
  • ДП - строка, представляющая пустую дату (например, Формат("00010101000000" ,"ДП=""пустая дата""") вернет строку "пустая дата").
  • БЛ - строка, представляющая логическое значение Ложь .
  • БИ - строка, представляющая логическое значение Истина .

Подробное описание. Нажмите чтобы развернуть

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

Параметры форматирования перечисляются через символ “;”. Наличие параметра означает отличие форматирования от стандартного.

Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (0 и 01.01.0001 00:00:00 соответственно) будет выдаваться пустая строка.

Каждый параметр задается именем параметра, символом “=” и значением параметра. Значение параметра может указываться в одинарных или двойных кавычках. Это необходимо, если значение параметра содержит символы, используемые в синтаксисе форматной строки.

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

Имена и значения параметров форматной строки:

  • Л – имя языка, страны, для которых будет выполняться стандартное форматирование.
  • ЧЦ – общее число отображаемых десятичных разрядов целой и дробной частей. Исходное число округляется при этом в соответствии с правилами округления. Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.
  • ЧДЦ – число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилами округления.
  • ЧС – сдвиг разрядов: положительный – деление, отрицательный – умножение. Другими словами, это означает, что исходное число будет умножено или поделено на 10*С, где С – значение параметра по модулю.
  • ЧРД – символ-разделитель целой и дробной части.
  • ЧРГ – символ-разделитель групп целой части числа. Если в качестве разделителя использовать пустую строку, то в этом случае разделителем будет символ неразрывного пробела.
  • ЧН – строка, представляющая нулевое значение числа. Если не задано, то представление в виде пустой строки. Если задано “ЧН=”, то в виде “0”. Не используется для числовых полей ввода.
  • ЧВН – нужно ли выводить лидирующие нули. Значение данного параметра не задается, собственно наличие параметра определяет вывод лидирующих нулей.
  • ЧГ – порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Имеют смысл только два первых числа. Первое из них указывает первичную группировку, то есть ту, которая будет использована для наименее значимых разрядов целой части числа. Если второе число не указано, то будут сгруппированы только наименее значимые разряды. Если в качестве второго числа задан 0, то для всех разрядов целой части числа будет применено значение указанное для первичной группировки. Если в качестве второго числа используется значение, отличное от 0, то это значение будет использовано для группировки всех разрядов, кроме уже сгруппированных наименее значимых.
  • ЧО – представление отрицательных чисел.
    • 0 (0) – строка вида “(1,1)”;
    • 1 (1) – строка вида “-1,1”;
    • 2 (2) – строка вида “- 1,1”;
    • 3 (3) – строка вида “1,1-“;
    • 4 (4) – строка вида “1,1 -“.
  • ДФ – формат даты.
    • д – день месяца (цифрами) без лидирующего нуля;
    • дд – день месяца (цифрами) с лидирующим нулем;
    • ддд – краткое название дня недели;
    • дддд- полное название дня недели;
    • М – номер месяца (цифрами) без лидирующего нуля;
    • ММ – номер месяца (цифрами) с лидирующим нулем;
    • МММ – краткое название месяца;
    • ММММ – полное название месяца;
    • к – номер квартала в году;
    • г – номер года без века и лидирующего нуля;
    • гг – номер года без века с лидирующим нулем;
    • гггг – номер года с веком;
    • ч – час в 12 часовом варианте без лидирующих нулей;
    • чч – час в 12 часовом варианте с лидирующим нулем;
    • Ч – час в 24 часовом варианте без лидирующих нулей;
    • ЧЧ (HH) – час в 24 часовом варианте с лидирующим нулем;
    • м – минута без лидирующего нуля;
    • мм – минута с лидирующим нулем;
    • с – секунда без лидирующего нуля;
    • сс – секунда с лидирующим нулем;
    • вв – отображение половины дня AM/PM (действительно только для языков конфигурирования, поддерживающих 12 часовой вариант представления времени).
  • ДЛФ – локальный формат даты. Указывается вариант отображения частей даты.
    • Д – дата (цифрами);
    • ДД – длинная дата (месяц прописью);
    • В – полное время, дата может объединяться со временем;
    • ДВ – дата время.
  • ДП – строка, представляющая пустую дату (например, Формат(‘00010101000000’ ,”ДП=””пустая дата”””) вернет строку “пустая дата”).
  • БЛ – строка, представляющая логическое значение Ложь .
  • БИ – строка, представляющая логическое значение Истина .

Встроенные функции языка.Формат (Script functions.Format)
Встроенные функции языка (Script functions)
Формат (Format)
Синтаксис:
Формат(<Значение>, <ФорматнаяСтрока>
Параметры:
<Значение> (обязательный)
Тип: Число; Дата; Булево. Форматируемое значение.
<ФорматнаяСтрока> (необязательный)
Тип: Строка. Форматная строка представляет собой строковое значение, включающее параметры форматирования.
Параметры форматирования перечисляются через символ ";". Наличие параметра означает отличие форматирования от стандартного.
Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (0 и 01.01.0001 00:00:00 соответственно) будет выдаваться пустая строка.
Каждый параметр задается именем параметра, символом "=" и значением параметра. Значение параметра может указываться в одинарных или двойных кавычках. Это необходимо, если значение параметра содержит символы, используемые в синтаксисе форматной строки. Внутри значения параметра могут указываться произвольные символы, которые при формировании результирующей строки будут отображаться как есть. Таким образом, например, можно указывать разделители часов, минут и секунд при форматировании времени. Если эти символы совпадают со значениями форматной строки их необходимо заключать в одинарные кавычки.
Имена и значения параметров форматной строки:
Л (L) - Имя языка, страны, для которых будет выполняться стандартное форматирование. Доступные имена языков:
af Африкаанс
af_ZA Африкаанс (Южная Африка)
am Амхарский
am_ET Амхарский (Эфиопия)
ar Арабский
ar_AE Арабский (Объединенные Арабские Эмираты)
ar_BH Арабский (Бахрейн)
ar_DZ Арабский (Алжир)
ar_EG Арабский (Египет)
ar_IQ Арабский (Ирак)
ar_JO Арабский (Иордания)
ar_KW Арабский (Кувейт)
ar_LB Арабский (Ливан)
ar_LY Арабский (Ливия)
ar_MA Арабский (Марокко)
ar_OM Арабский (Оман)
ar_QA Арабский (Катар)
ar_SA Арабский (Саудовская Аравия)
ar_SD Арабский (Судан)
ar_SY Арабский (Сирия)
ar_TN Арабский (Тунис)
ar_YE Арабский (Йемен)
as Ассамский
as_IN Ассамский (Индия)
az Азербайджанский
az_AZ Азербайджанский (Азербайджан)
az_Cyrl Азербайджанский (Кириллица)
az_Cyrl_AZ Азербайджанский (Кириллица, Азербайджан)
az_Latn Азербайджанский (Латиница)
az_Latn_AZ Азербайджанский (Латиница, Азербайджан)
be Белорусский
be_BY Белорусский (Беларусь)
bg Болгарский
bg_BG Болгарский (Болгария)
bn Бенгальский
bn_IN Бенгальский (Индия)
ca Каталанский
ca_ES Каталанский (Испания)
cs Чешский
cs_CZ Чешский (Чешская Республика)
cy Валлийский
cy_GB Валлийский (Великобритания)
da Датский
da_DK Датский (Дания)
de Немецкий
de_AT Немецкий (Австрия)
de_BE Немецкий (Бельгия)
de_CH Немецкий (Швейцария)
de_DE Немецкий (Германия)
de_LU Немецкий (Люксембург)
el Греческий
el_GR Греческий (Греция)
en Английский
en_AU Английский (Австралия)
en_BE Английский (Бельгия)
en_BW Английский (Ботсвана)
en_CA Английский (Канада)
en_GB Английский (Великобритания)
en_HK Английский (Гонконг, (Область с Особым Административным Управлением, Китай))
en_IE Английский (Ирландия)
en_IN Английский (Индия)
en_MT Английский (Мальта)
en_NZ Английский (Новая Зеландия)
en_PH Английский (Филиппины)
en_PK Английский (Пакистан)
en_SG Английский (Сингапур)
en_US Английский (Соединенные Штаты Америки)
en_VI Английский (Американские Виргинские Острова)
en_ZA Английский (Южная Африка)
en_ZW Английский (Зимбабве)
es Испанский
es_AR Испанский (Аргентина)
es_BO Испанский (Боливия)
es_CL Испанский (Чили)
es_CO Испанский (Колумбия)
es_CR Испанский (Коста-Рика)
es_DO Испанский (Доминиканская Республика)
es_EC Испанский (Эквадор)
es_ES Испанский (Испания)
es_GT Испанский (Гватемала)
es_HN Испанский (Гондурас)
es_MX Испанский (Мексика)
es_NI Испанский (Никарагуа)
es_PA Испанский (Панама)
es_PE Испанский (Перу)
es_PR Испанский (Пуэрто-Рико)
es_PY Испанский (Парагвай)
es_SV Испанский (Сальвадор)
es_US Испанский (Соединенные Штаты Америки)
es_UY Испанский (Уругвай)
es_VE Испанский (Венесуэлла)
et Эстонский
et_EE Эстонский (Эстония)
eu Баскский
eu_ES Баскский (Испания)
fa Персидский
fa_AF Персидский (Афганистан)
fa_IR Персидский (Иран)
fi Финский
fi_FI Финский (Финляндия)
fo Фарерский
fo_FO Фарерский (Фарерские острова)
fr Французский
fr_BE Французский (Бельгия)
fr_CA Французский (Канада)
fr_CH Французский (Швейцария)
fr_FR Французский (Франция)
fr_LU Французский (Люксембург)
ga Ирландский
ga_IE Ирландский (Ирландия)
gl Галисийский
gl_ES, Галисийский (Испания)
gu Гуярати
gu_IN Гуярати (Индия)
he Иврит
he_IL Иврит (Израиль)
hi Хинди
hi_IN Хинди (Индия)
hr Хорватский
hr_HR Хорватский (Хорватия)
hu Венгерский
hu_HU Венгерский (Венгрия)
hy Армянский
hy_AM Армянский (Армения)
hy_AM_REVISED Армянский (Армения, REVISED)
id Индонезийский
id_ID Индонезийский (Индонезия)
is Исландский
is_IS Исландский (Исландия)
it Итальянский
it_CH, Итальянский (Швейцария)
it_IT Итальянский (Италия)
ja Японский
ja_JP Японский (Япония)
ka Грузинский
ka_GE Грузинский (Грузия)
kk Казахский
kk_KZ Казахский (Казахстан)
kl Гренландский
kl_GL Гренландский (Гренландия)
kn Каннада
kn_IN Каннада (Индия)
ko Корейский
ko_KR Корейский (Южная Корея)
kok Конкани
kok_IN Конкани (Индия)
lt Литовский
lt_LT Литовский (Литва)
lv Латышский
lv_LV Латышский (Латвия)
mk Македонский
mk_MK Македонский (Македония)
ml Малаялам
ml_IN Малаялам (Индия)
mr Маратийский
mr_IN Маратийский (Индия)
ms Малайский
ms_BN Малайский (Бруней)
ms_MY Малайский (Малайзия)
mt Мальтийский
mt_MT Мальтийский (Мальта)
nb Норвежский букмол
nb_NO Норвежский букмол (Норвегия)
nl Голландский
nl_BE Голландский (Бельгия)
nl_NL Голландский (Нидерланды)
nn Норвежский нюнорск
nn_NO Норвежский нюнорск (Норвегия)
om Оромо (Афан)
om_ET Оромо (Афан) (Эфиопия)
om_KE Оромо (Афан) (Кения)
or Ория
or_IN Ория (Индия)
pa Панджабский
pa_IN Панджабский (Индия)
pl Польский
pl_PL Польский (Польша)
ps Пашто (Пушто)
ps_AF Пашто (Пушто) (Афганистан)
pt Португальский
pt_BR Португальский (Бразилия)
pt_PT Португальский (Португалия)
ro Румынский
ro_RO Румынский (Румыния)
ru Русский
ru_RU Русский (Россия)
ru_UA Русский (Украина)
sk Словацкий
sk_SK Словацкий (Словакия)
sl Словенский
sl_SI Словенский (Словения)
so Сомали
so_DJ Сомали (Джибути)
so_ET Сомали (Эфиопия)
so_KE Сомали (Кения)
so_SO Сомали (Сомали)
sq Албанский
sq_AL Албанский (Албания)
sr Сербский
sr_CS Сербский (Сербия и Черногория)
sr_Cyrl Сербский (Кириллица)
sr_Cyrl_CS Сербский (Кириллица, Сербия и Черногория)
sr_Cyrl_YU Сербский (Кириллица, Югославия)
sr_Latn Сербский (Латиница)
sr_Latn_CS Сербский (Латиница, Сербия и Черногория)
sr_Latn_YU Сербский (Латиница, Югославия)
sr_YU Сербский (Югославия)
sv Шведский
sv_FI Шведский (Финляндия)
sv_SE Шведский (Швеция)
sw Суахили
sw_KE Суахили (Суахили)
sw_TZ Суахили (Танзания)
ta Тамильский
ta_IN Тамильский (Индия)
te Телугу
te_IN Телугу (Индия)
th Тайский
th_TH Тайский (Таиланд)
ti Тигриниа
ti_ER Тигриниа (Эритрея)
ti_ET Тигриниа (Эфиопия)
tr Турецкий
tr_TR Турецкий (Турция)
uk Украинский
uk_UA Украинский (Украина)
ur Урду
ur_PK Урду (Пакистан)
uz Узбекский
uz_Cyrl Узбекский (Кириллица)
uz_Cyrl_UZ Узбекский (Кириллица, Узбекистан)
uz_Latn Узбекский (Латиница)
uz_Latn_UZ Узбекский (Латиница, Узбекистан)
uz_UZ Узбекский (Узбекистан)
vi Вьетнамский
vi_VN Вьетнамский (Вьетнам)
zh Китайский
zh_CN Китайский (Китай)
zh_Hans Китайский (Hans)
zh_Hans_CN Китайский (Hans, Китай)
zh_Hans_SG Китайский (Hans, Сингапур)
zh_Hant Китайский (Hant)
zh_Hant_HK Китайский (Hant, Гонконг (Область с Особым Административным Управлением, Китай))
zh_Hant_MO Китайский (Hant, Макао (Область с Особым Административным Управлением, Китай))
zh_Hant_TW Китайский (Hant, Тайвань)
zh_HK Китайский (Гонконг (Область с Особым Административным Управлением, Китай))
zh_MO Китайский (Макао (Область с Особым Административным Управлением, Китай))
zh_SG Китайский (Сингапур)
zh_TW Китайский (Тайвань)
ЧЦ (ND) - Общее число отображаемых десятичных разрядов целой и дробной частей. Исходное число округляется при этом в соответствии с правилами округления Окр15как20. Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.
ЧДЦ (NFD) - Число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилами округления Окр15как20.
ЧС (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) - отображение половины дня AM/PM (действительно только для языков конфигурирования, поддерживающих 12 часовой вариант представления времени).
Примечание: *) - не используется для форматной строки поля ввода даты.
ДЛФ (DLF) - Локальный формат даты. Указывается вариант отображения частей даты.
Д (D) - дата (цифрами);
ДД (DD) - длинная дата (месяц прописью);
В (T) - полное время, дата может объединяться со временем;
ДВ (DT) - дата время.
Пример: выражение Формат("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";

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

Программирование (и бизнес программы) обычно имеют дело со следующими простыми типами данных: число, строка, дата. Значения этих типов для разных стран, стандартов и просто привычек могут иметь разное представление.

Вероятно самый известный пример, это разное представление времени – в России привычно использовать 9:00 и 21.00, а в англоязычных странах 9am и 9pm. Разница как в логике (12ти часовая система или 24х часовая), так и в написании.

Представление значения называется «формат» и сегодня мы обсудим изменение формата даты и формата числа в 1С.
Использовать форматирование можно как программисту в языке 1С, так и визуально, без программирования, например при создании печатной формы или отчета, при настройке элементов на форме.

Что такое форматирование

Число и дата вне зависимости от его представления на экране или на печати – остается самим собой. Форматирование подразумевает собой исключительно преобразование к строковому значению – то есть как он будет «выглядеть» на экране компьютера или на бумаге.

Основные различия форматов 1С представления чисел и дат:

  • Число
    o «.» или «,» для отделения дробной части
    o количество знаков после запятой
    o группировка цифр в числе по 3 (1 000 000, а не 1000000)
  • Дата и время
    o порядок года, месяца, дня
    o символ-разделитель
    o формат 1С времени (12 или 24 часа)
    o детали написания.

Также в формате 1С могут быть указаны дополнительные «удобства», например отрицательные числа выводить красным цветом, или представление «пустого значения» в виде «0» или «не заполнено».

Принцип форматирования

Форматирование по умолчанию работает, например, при переводе числа в строку. В некоторых случаях такие настройки могут служить дурную службу там, где программист этого и не ожидает.

Например, при переводе числа в строку оно переводится с учетом группировки цифр (а вы этого ожидаете?):
ЧислоСтрокой = СокрЛП(2400); //будет равно «2 400»

Для точного указания формата в языке 1С есть функция Формат(), с помощью которой возможно указать требуемое представление.
ЧислоСтрокой = Формат(2400, «Настройки»)

В качестве строки «Настройки» нужно указать требуемый формат 1С. Такие настройки указываются в специальном закодированном виде. Рассмотрим наиболее часто используемые настройки:

Формат 1С даты и числа по умолчанию

Если Вам требуется вывести дату или число и не хочется заморачиваться со знанием как они должны быть представлены по правилам нужной страны, есть простейшая настройка, которая позволит Вам это сделать:

L = КраткоеНаименованиеНужнойСтраны

Пример вывода даты по правилам некоторых стран:
Формат(ТекущаяДата(), «L=ru»)
> 28.03.2012 14:21:32

Формат(ТекущаяДата(), «L=en»)
> 3/28/2012 2:21:24 PM

Формат(ТекущаяДата(), «L=fr»)
> 28/03/2012 14:22:08

Как не трудно заметить, названия стран — интуитивны.

Формат даты в языке 1С

Если настройки по умолчанию Вам недостаточно и хотелось бы самостоятельно указать порядок частей даты и символы их разделения, необходимо использовать настройку:
ДФ = «дмг чмс»

Соответственно «дмг» – это день, месяц и год, а «чмс» — это часы, минуты и секунды. Любую из этих частей возможно пропустить. Порядок следования – любой. Символы, указанные между частями будут использованы как символы разделения.

Символ части даты может быть указан несколько раз подряд, от этого зависит вид этой части даты, например «д» или «дд» или «дддд».

Расшифровка частей даты:

  • д – день
    o маленькая «д»
  • М – месяц
    o большая «М»
    o может быть указана от 1 до 4 раз
  • г – год
    o маленькая «г»
    o может быть указана 1 или 2 или 4 раза
  • ч – часы
    o маленькая «ч» — 12ти часовой формат
    o большая «Ч» — 24х часовой формат
  • м – минуты
    o маленькая «м»
    o может быть указана 1 или 2 раза
  • с – секунды
    o маленькая «с»
    o может быть указана 1 или 2 раза
  • вв – отображение AM/PM для 12ти часового формата
  • к – квартал.

Пример вывода даты с указанием правил:
Формат(ТекущаяДата(), "ДФ=""дд.ММ.гггг чч:мм:сс""")
> 28.03.2012 02:44:44

Формат(ТекущаяДата(), "ДФ="" М / д /гггг ч:м:с вв""")
> 3/28/2012 2:44:44 PM

Формат(ТекущаяДата(), "ДФ=""дд/ММ/гггг чч:мм:сс""")
> 28/03/2012 02:44:44

Формат числа в языке 1С
В отличие от форматирование даты, где все достаточно просто, для форматирования числа есть много параметров. Мы рассмотрим те, которые нам показались полезными – то есть по нашему мнению часто применяются.

Первая «проблема» связана с группировкой по умолчанию цифр в числах по 3 и разделением групп пробелом, например:
СтрЧисло = Строка(22300500)
> 22 300 500

Это неудобно, когда число преобразовывается к строке не для красивого и понятного вывода пользователю, а для служебных нужд. На это можно повлиять с помощью параметра «ЧГ», например:

Формат(22300500, "ЧГ=100")
>22300500 //вообще убрали нули

Формат(22300500, "ЧГ=6")
> 22 300500 //сделали группировку только миллионов

Параметр, который позволяет округлить число при выводе до нужного количества цифр после запятой «ЧДЦ»:

Формат(3.535353, "ЧДЦ=""2""")
> 3,54

Параметр, который позволяет указать символ-разделитель целой и дробной части «ЧРД»:

Формат(3.535353, "ЧРД="".""")
> 3.535353

Для некоторых случаев бывает полезно иметь возможность вместо числа «0» отображать что-то другое: пустую строку или «не заполнено». Это позволяет делать параметр «ЧН»:

Формат(0, "ЧН=""""")
>

Формат 1С поля на форме

Мы рассмотрели с Вами приемы, которые позволяют программисту форматировать значение в языка 1С. Также есть механизмы, которые позволяют указать требуемый формат визуально, без программирования.

Например, пользователь работает с формой. На форме есть поле, которое отображает дату. Мы можем повлиять на представление этой даты.

Откройте свойства этого поля. Для этого — в толстом клиенте нажмите правой кнопкой на поле, а в тонком — правой кнопкой на имени поля в списке полей, выберите пункт Свойства.
У поля есть свойство «Формат».

Нажмите кнопку «…», чтобы настроить его. Для настройки формата даты используйте закладку Дата (для числа – закладку Число). Вы можете выбрать требуемый формат из списка.

Формат 1С ячейки в печатной форме

Когда нужно разработать печатную форму (отчет или печать документа), можно назначить формат ячейки точно таким же способом, как и для поля документа.
Выбираем ячейку (или несколько ячеек одновременно), заходим в свойства, свойство «Формат», выбираем требуемый формат.

Формат 1С в СКД

Отчеты СКД позволяют настроить формат 1С как программисту (в момент создания отчета), так и пользователю (при использовании отчета). Также возможностей больше за счет использования условного форматирования.

Это значит Вы не только указываете какое поле как форматировать, но и при каком условии (например, если значение этого поля – отрицательное).

В режиме Предприятие выберите пункт меню на форме отчета «Изменить вариант». В отчете СКД в толстом клиенте этот пункт в меню «Действия/Настройки».

В открывшейся форме всех настроек СКД есть закладка «Условное форматирование». Добавьте новую строчку. В строчке три колонки:

  • Оформление. Укажите требуемый формат 1С — шрифт, цвет фона или текста, формат 1С отображения числа и даты
  • Условие. Если данное оформление применять всегда – то оставьте это поле пустым. Иначе – укажите поле и его значение. Тогда форматирование будет применено только в тех строках, в которых эти значения совпадают. Если требуется указать значения нескольких полей одновременно и условий «и/или» — добавьте группу и сгруппируйте поля с помощью групп.
  • Оформляемые поля. Список полей, для которых будет применено форматирование.

Формат 1С в управляемых формах

Аналогичные правила форматирования действуют в любой форме списка управляемого клиента. В форме списке выберите пункт меню «Все действия/Настроить список».

Закладка Условное оформление.

Выбираем требуемое оформление и формат.

Указываем список полей, на которые будет применено это оформление.

Основные типы данных в 1С – число, булево и дата, могут быть представлены множеством форматов. Программисты часто сталкиваются с тем, что требования к виду данных сильно различаются в разных отчетах и таблицах. Разработчики 1С подумали об удобстве программистов и создали специальную функцию, существенно облегчающую процесс изменения внешнего вида данных. Основная задача функции – привести число, дату или логический тип к нужному виду строкового типа.

Описание функции «Формат»

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

ОтформатированноеЗначение = Формат(ПеременнаяДляФорматирования,ТекстоваяФорматнаяСтрока);

Если параметр «ФорматнаяСтрока» не задан, то 1С преобразует заданное значение в строку. Помните, что пустая дата и 0 будут преобразованы к пустой строке, что может не понравиться пользователям. Каждый параметр в форматной строке представляет собой комбинацию из наименования, символа «=» и значения, указываемого в кавычках. Это позволяет предусматривать вкрапление символов, используемых в написании форматной строки функции Формат в 1С.

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

Для удобства разработчиков в 1С встроен конструктор форматной строки. К нему можно обратиться в модулях через контекстное меню или в СКД через предусмотренные разработчиками места. К примеру, такую возможность можно обнаружить в списке полей для запроса в разделе «Оформление».

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

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

Основные параметры форматной строки

Изучить все доступные команды не получится, и в этом нет необходимости. Разработчику достаточно лишь знать некоторые популярные операции и как их применять. В любой момент вы сможете в синтакс-помощнике открыть полный перечень параметров форматной строки и выбрать нужный. Программисту 1С могут пригодиться в ежедневной работе следующие параметры:

  • Л – формат страны, для представителей которой будут выводиться данные;
  • ЧГ – задает группировку разрядов числа;
  • ЧЦ – устанавливает общее количество групп символов целой и дробной части числа, которые будут выводиться на просмотр. Если в форматной строке с этим ключом не задано значение параметра ЧДЦ, то дробная часть не будет показана;
  • ЧДЦ – параметр, задающий число символов в части числа после запятой. Округление происходит в соответствии со стандартными правилами математики;
  • ЧС – параметр, сдвигающий разряды числа. Значение может быть положительным – умножение на 10, или отрицательным – деление. Полезная команда, если вам нужно вывести в одном виде, а продолжить работу с числом в другом;
  • ЧРД – задает символ, разделяющий дробную и целую части числа. Чтобы установить символ, разделяющий группы целой части, используйте «ЧРГ». Для применения неразрывного пробела используйте пустую строку;
  • ЧВН – показывает использование лидирующих нулей. Значение этого параметра не задается;
  • ДФ – один из самых часто встречаемых параметров форматной строки. Управляет форматом даты. В 1С с помощью команды «Формат» можно вывести дату практически в любом формате, включая написание названия месяца. Возможных значений много, их перечень можно увидеть в синтакс-помощнике;
  • БЛ и БИ – устанавливают представление для логического типа данных, отвечая, соответственно, за ложь и истину. Таким образом, стандартную «галочку» вы сможете заменить любым словом или фразой, более доходчивой для пользователей.

Универсализм и удобство конструктора стали ключевыми причинами популярности функции «Формат» среди разработчиков 1С. Гибкие настройки помогут вам задать любой внешний вид данным по желанию клиента.

Понравилась статья? Поделитесь ей