0

Структура форматной строки 1с 8.3

Форматная строка используется в функции Формат() для представления значений простых типов (Число, Дата и Булево) в строковом виде.

Форматная строка представляет собой строковое выражение, состоящее из параметров форматирования, перечисленных через точку с запятой (;). Каждый параметр задается именем параметра и значением, указанным после символа равно (=). Значение параметра может заключаться в одинарные кавычки (‘). Например:

"Л=ru; ЧЦ=15; ЧДЦ=2; ДФ='dd.MM.yyyy'"

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

Имя параметра Описание
Л (L) имя языка или страны, для которых будет выполняться стандартное форматирование. Доступные варианты:

  • en — Английский
  • en_GB — Английский (Великобритания)
  • en_US — Английский (Соединенные Штаты Америки)
  • ru — Русский
  • ru_RU — Русский (Россия)
  • uk — Украинский
  • uk_UA — Украинский (Украина)
  • be — Белорусский
  • be_BY — Белорусский (Беларусь)

С полным перечнем кодов языков и стран можно ознакомиться в синтакс-помощнике в режиме 1С:Конфигуратор

Параметры форматной строки для типа Число

Имя параметра Описание
ЧЦ (ND) устанавливает общую длину представления числа (целой и дробной частей вместе взятых). При этом исходное число округляется в соответствии с общепринятыми правилами округления (0.5 как 1). Если этот параметр задан, то для отображения дробной части числа обязательно указание следующего параметра ЧДЦ, иначе дробная часть отображаться не будет.

ЧЦ=15
ЧДЦ (NFD) устанавливает длину дробной части представления числа. Исходное число округляется при этом в соответствии с общепринятыми правилами округления (0.5 как 1).

ЧДЦ=2
ЧС (NS) устанавливает сдвиг разрядов: положительный — деление, отрицательный — умножение. Иными словами, исходное число будет умножено или поделено на 10 в степени n, где n — значение параметра
ЧРД (NDS) устанавливает символ-разделитель целой и дробной части

ЧРД=.
ЧРГ (NGS) устанавливает символ-разделитель триад целой части числа. Если в качестве разделителя использовать пустую строку, то в этом случае разделителем будет символ неразрывного пробела

ЧРГ=
ЧН (NZ) устанавливает представление для нулевого значения числа. По умолчанию число 0 представляется в виде пустой строки. Если задано только имя параметра, а значение не задано, то число 0 выводится как есть.

ЧН=
Внимание! Для числовых полей ввода этот параметр игнорируется
ЧВН (NLZ) определяет вывод лидирующих нулей для числа: если параметр задан, лидирующие нули выводятся; если не задан — не выводятся

ЧВН=
ЧГ (NG) определяет порядок группировки разрядов числа. В качестве значения указываются числа, через запятую, обозначающие количество группируемых разрядов справа налево. Имеют смысл только два первых числа. Первое из них указывает первичную группировку, которая будет использована для наименее значимых разрядов целой части числа. Если второе число не указано, то будут сгруппированы только наименее значимые разряды. Если в качестве второго числа задан 0, то для всех разрядов целой части числа будет применено значение указанное для первичной группировки. Если в качестве второго числа используется значение, отличное от 0, то это значение будет использовано для группировки всех разрядов, кроме уже сгруппированных наименее значимых.

ЧГ=3,0
ЧО (NN) определяет код представления отрицательных чисел. Возможные варианты:

0 представление отрицательных чисел в скобках: -1 как (1)
1 стандартное представление отрицательных чисел: -1 как -1
2 стандартное представление отрицательных чисел минус через пробел: -1 как — 1
3 представление отрицательных чисел с суффиксом: -1 как 1-
4 представление отрицательных чисел с суффиксом через пробел: -1 как 1 —
ЧО=1
ЧФ (NF) задает шаблон форматирования числа. Позиция исходного числа, отформатированного с учетом остальных параметров, указывается символом Ч. Остальные символы выводятся как есть. Символы, находящиеся между двойными или одинарными кавычками выводятся как есть

ЧФ='Ч тыс'
Внимание! Шаблон форматирования не применяется к числу 0, если только в форматной строке не присутствует параметр ЧН

Примеры форматной строки для числовых значений:

Форматная строка Исходное число Представление
ЧЦ=15 987 654,521 987 655
ЧЦ=15; ЧДЦ=2 987 654,521 987 654,52
ЧЦ=15; ЧДЦ=2; ЧГ=0 987 654,521 987654,52
ЧЦ=15; ЧДЦ=2; ЧС=3; ЧФ=’Ч тыс’ 987 654,521 987,65 тыс

Параметры форматной строки для типа Дата

Имя параметра Описание
ДФ (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 (поддерживается не для всех языков!)
ДФ='dd.MM.yyyy'
ДЛФ (DLF) задает фиксированный локальный формат даты (составленный с учетом особенностей региональных установок ИБ). Возможные варианты:

Д (D) дата цифрами
ДД (DD) длинная дата, где месяц указан прописью
В (T) время
ДВ (DT) дата цифрами и время
ДДВ (DDT) длинная дата (месяц прописью) и время
ДЛФ=ДВ
Внимание! Для поля ввода типа Дата параметр используется только со значениями Д (D), В(T) и ДВ (DT)
ДП (DE) представление пустой даты. По умолчанию, пустая дата выводится пустой строкой. Если задано только имя параметра, а значение не задано, то пустая дата выводится в виде 01.01.0001 0:00:00

ДП=-
Внимание! Параметр не используется для поля ввода даты!

Примеры форматной строки для типа Дата:

Форматная строка Исходная дата Представление
ДФ=dd.MM.yyyy 24.10.2019 10:15:30 24.10.2019
ДФ=’MMMM yyyy »г.»’ 24.10.2019 10:15:30 Октябрь 2019 г.
ДЛФ=DD 24.10.2019 10:15:30 24 октября 2019 г.

Параметры форматной строки для типа Булево

Имя параметра Описание
БЛ (BF) задает строковое представление логического значения ЛОЖЬ

БЛ=Нет
БИ (BT) задает строковое представление логического значения ИСТИНА

БЛ=Да

Читайте также:

Добавить комментарий

Ваш e-mail не будет опубликован. Обязательные поля помечены *