2 378 документов
← К списку

5.65 Формат параметров

страница

При работе в приложении бывают ситуации, когда пользователю требуется выводить число или дату в каком-либо особенном виде, например, можно отформатировать дату, указав месяц прописью, или получить форматированное число, с двумя знаками после запятой. Для этого можно применить Формат параметров. Для форматирования значений в приложении предназначено окно – Конструктор форматной строки, которое открывается при подготовке рассылки отчетов, шаблонов сообщений, печатных форм и в дополнительных реквизитах.В Конструкторе форматной строки, в зависимости от выбранного типа параметра, можно вывести отличный от стандартного типы (Число, Дата, Булево).

Формат чисел

ЧЦ –  максимальная длина целой части числа.

Пример для параметра [Сумма]

Исходное значение

Результат

ЧЦ = 6

545 787,321

545 787

ЧДЦ – число десятичных разрядов в дробной части.

Пример для параметра [Сумма]

Исходное значение

Результат

ЧДЦ = 4

545 787,321

545 787,3210

ЧС – сдвиг разрядов: положительный - деление, отрицательный - умножение.

Пример для параметра [Сумма]

Исходное значение

Результат

ЧC = 1

545 787,321

54 578,7321

ЧС = -1

545 787,321

5 457 873,21

ЧРД – символ-разделитель целой и дробной части.

Пример для параметра [Сумма]

Исходное значение

Результат

ЧРД =.

545 787,321

545 787.321

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

Пример для параметра [Сумма]

Исходное значение

Результат

ЧРГ =,

545 787,321

545,787,321

ЧГ – порядок группировки разрядов числа.

Пример для параметра [Сумма]

Исходное значение

Результат

ЧГ = 0

545 787,321

545787,321

ЧН – строка, представляющая нулевое значение числа. Если параметр отсутствует, то нулевое значение будет представлено пустой строкой.

Пример для параметра [Номер]

Исходное значение

Результат

ЧН = Пусто

0,000

Пусто

ЧВН – нужно ли выводить лидирующие нули. Значение данного параметра не задается, собственно наличие параметра определяет вывод лидирующих нулей.

Пример для параметра [Номер]

Исходное значение

Результат

ЧЦ = 5; ЧВН =; ЧГ = 0

55,000

00055

ЧО – представление отрицательных чисел.

Пример для параметра [Итог]

Исходное значение

Результат

ЧО = 0

-545 787,321

(545 787,321)

ЧО = 1

-545 787,321

-545 787,321

ЧО = 3

-545 787,321

545 787,321-

ЧФ – задает шаблон форматирования числа. Позиция исходного числа, отформатированного с учетом остальных параметров, указывается символом Ч. Остальные символы выводятся как есть.

Пример для параметра [Сумма]

Исходное значение

Результат

ЧЦ = 15; ЧДЦ = 2; ЧС = 3; ЧФ = Ч тыс

545 787,321

545,79 тыс

Формат даты

ДЛФ - локальный формат даты. Указывается вариант отображения частей даты. Рекомендуется использовать данный формат, т.к. локальный формат для чисел и дат зависит от языка. Если выбрать нужный язык из списка, то локальный формат числа и даты будет указываться в соответствии с выбранным языком. В ином случае – будет использоваться текущий язык.

● D - дата (цифрами);

● DD - длинная дата (месяц прописью);

● T - полное время, дата может объединяться со временем;

● DT - дата время.

Пример для параметра [Дата]

Исходное значение

Результат

ДЛФ = DD

10.10.2022 18:10:05

10 октября 2022 г.

ДЛФ = DDT

10.10.2022 18:10:05

10 октября 2022 г. 18:10:05

ДЛФ = D

10.10.2022 18:10:05

10.10.2022

ДЛФ = T

10.10.2022 18:10:05

18:10:05

ДФ – задает произвольный шаблон даты с помощью подстановочных символов.

● 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

Пример для параметра [Дата документа]

Исходное значение

Результат

ДФ = d.M.yy

01.01.2022 18:10:05

1.1.22

ДФ = HH:mm:ss

01.01.2022 18:10:05

18:10:05

ДФ = yyyy-MM-dd

10.10.2022 18:10:05

2022-10-10

 

ДП – представление пустой даты.

Пример для параметра [Дата отчета]

Исходное значение

Результат

ДП = -

(пустая дата)

-

ДП = Нет даты

(пустая дата)

Нет даты

ДП = Сейчас

(пустая дата)

Сейчас

Формат Булево

БЛ – строка, представляющая логическое значение Ложь.

БИ – строка, представляющая логическое значение Истина.

Примеры для параметров [Доступность товара]  и [Важность]

Исходное значение

Результат

БЛ=Отсутствует; БИ=Доступен

Истина

Доступен

БЛ=Обычный; БИ=Важный

Ложь

Обычный

Прочие параметры

Л – имя языка или страны, для которых будет выполняться форматирование чисел, дат и значений типа булево.

Примеры для параметров [Дата] и [Сумма]

Исходное значение

Результат

Л = en (англ.)

10.10.2022 18:01:05

10/10/2022 6:01:05 PM

Л = de (нем.)

Истина

Ja

Л = it_IT (итальян.)

5 749 321,123

5.749.321,123

Формат параметров в рассылке отчетов

При создании Рассылки отчетов заходим во вкладку Доставка, в Теме письма укажем нужную нам функцию формата Даты с помощью Параметра форматной строки, также укажем Формат даты рассылки. (При желании прописать формулу можно и вручную. Это не повлияет на результат) см. раздел Администрирование – Печатные формы, отчеты, обработки – Рассылки отчетов.

Формат параметров в макетах печатных форм

Создадим новый Макет печати с помощью Конструктора печатных форм, в поле списка доступных реквизитов укажем нужный формат, нажмем на кнопку (настройка формата поля) и выберем формат Процента оплаты, отличный от стандартного см. раздел Администрирование – Печатные формы, отчеты, обработки – Макеты печатных форм.

Формат параметров в шаблонах сообщений

Создадим новый Шаблон сообщений. Выберем нужный Параметр и зададим формат отображения реквизита (вызовем контекстное меню) см. раздел Администрирование – Органайзер – Заметки, напоминания, анкетирование, шаблоны сообщений – Шаблоны сообщений.

Формат параметров в дополнительных реквизитах

Создадим Дополнительные реквизиты Срок оплаты и Согласован с клиентом (да/нет) для документа Счет на оплату покупателю. Далее, применим соответствующие параметры формата для типа Даты и Булево. Включить возможность создавать дополнительные реквизиты и сведения и настроить их можно в разделе Администрирование — Общие настройки.