Формат (Format)

Описание:

Форматирует заданное значение с соответствии с определенными параметрами форматирования.

Синтаксис:

Формат(<Значение>, <Cтрока>)

Format(<Value>, <String>)

Параметры:

Значение (Value) - форматируемое значение, может быть числом, датой или логическим значением. Параметр является обязательным.

Cтрока (String) - строковое значение, включающее параметры форматирования. Параметр не является обязательным.

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

Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа число "0" будет выдаваться пустая строка.

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


  • ЧЦ (ND) - Общее число отображаемых десятичных разрядов целой и дробной частей. Исходное число округляется при этом в соответствии с правилом округления к ближайшему целому (например, числа 1.1 - 1.4 округляются до числа 1, а числа 1.5 - 1.9 округляются до числа 2). Если указан этот параметр, то для отображения дробной части числа обязательно указание параметра ЧДЦ, иначе дробная часть отображаться не будет.  
  • ЧДЦ (NFD) - Число десятичных разрядов в дробной части. Исходное число округляется при этом в соответствии с правилом округления к ближайшему целому (например, числа 1.21 - 1.24 округляются до числа 1.2, а числа 1.25 - 1.29 до числа 1.3).  
  • ЧРД (NDS) - Символ-разделитель целой и дробной части. По умолчанию '.' 
  • ЧРГ (NGS) - Символ-разделитель групп целой части числа. По умолчанию пробел. 
  • ЧН (NZ) - Строка, представляющая нулевое значение числа. Если не задано, то представление в виде пустой строки. 
  • ЧВН (NLZ) - Нужно ли выводить лидирующие нули. 0 -  не нужно, иначе нужно. 
  • ЧГ (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 часовой вариант представления времени).  


  • БЛ (BF) - Строка, представляющая логическое значение "Ложь".  
  • БИ (BT) - Строка, представляющая логическое значение "Истина". 


Возвращаемое значение:

Строка, полученная в результате форматирования переданного значения.

Пример:

// Примеры форматирования чисел
А = Формат(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";