1С 8.х : Функция «Формат»

Описание:

Формирует удобное для чтения представление значений. Полезно использование в отчетах и при прочем визуальном отображении значений.

Параметры:

<Значение>

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

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

[su_spoiler title=»Подробное описание. Нажмите чтобы развернуть» icon=»plus-square-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’ ,»ДП=»»пустая дата»»») вернет строку «пустая дата»).
  • БЛ — строка, представляющая логическое значение Ложь.
  • БИ — строка, представляющая логическое значение Истина.

[/su_spoiler]

Далее примеры: