Описание встроенного языка системы 1С Предприятие

       

Формат


Устанавливает формат для вывода всех выражений в ячейках облас­ти таблицы.

Синтаксис:

Формат(<СтрокаФормата>)

Англоязычный синоним:

Format

Параметры:

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

Необязательный параметр. Строковое выражение, содержащее форматную строку (см. Формат).



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

Строковое значение, содержащее текущую форматную строку по умолчанию для области таблицы (на момент до исполнения метода).

Описание:

Метод Формат устанавливает формат для вывода всех выражений выводи­мых в ячейках области таблицы.

Пример:

ВыбОбласть.Формат("415.2");




Если в форматной строке указано "(0)" перед всеми прочими специфика­циями, то все позиции в поле вывода числа, соответствующие незадействован­ным старшим разрядам будут заполнены символами "0". Например:

Формат(123.15, "Ч(0)10.2") = 0000123.15

Если в форматной строке проставить символ "-" перед длиной поля, то ну­левые значения при выводе будут отображаться прочерком. Пример: "4-17.2 ".

В форматной строке для числа можно использовать сдвиг разрядов при вы­воде. Это позволяет, например, отображать числовое значение в тысячах и т. п. В этом случае форматная строка должна заканчиваться символами ">Х" , где Х — количество сдвигаемых разрядов. Например, форматная строка: "Ч010>3" — означает вывод числа в тысячах (сдвиг на три разряда).

Строковое представление числа всегда является правоустановленным.

Кроме того, возможен вывод денежных величин и просто целых чисел про­писью. В этом случае форматная строка должна иметь вид "ЧПДС". Наличие буквы "П" (в английском варианте для аналогичной цели используется буква "S") определяет сам факт вывода числа прописью. Символ "Д" (в английском варианте — "M") обозначает вывод денежной величины и является необяза­тельным. Символ "С" (в английском варианте — "H") также необязателен и означает вывод с копейками.

Для форматирования строк используется следующая форматная строка:

"Сn", где n — положительное целое число определяющее ширину поля, в кото­ром будет размещаться строка. В случае, если ширина поля превосходит длину строки сформатированная строка будет дополнена справа пробелами, если же ширина поля меньше длины строки — строка будет усечена справа.

Для форматирования даты используется форматная строка вида "Д<ПодстрокаФормата>", где <Подстрока Формата> представляет собой строку, определяющую вид сформатированного представления даты:

DDMMYY (ДДММГГ)

дата в виде ДД.ММ.ГГ

DDMMYYYY

(ДДММГГГГ)

дата в виде ДД.ММ.ГГГГ

DDMMMMYYYY

(ДДММММГГГГ)

дата в виде ДД месяц прописью ГГГГ

(0)DDMMMMYYYY

((0)ДДММММГГГГ)

этот формат представляет собой вариант предыдущего формата с тем отличием, что число месяца всегда выводится двумя цифрами, т. е. для чисел меньших 10 спереди будет добавлен 0. Например: Формат('01.01.1999', ' 'Д(0)ДДММММГГГГ' ') = 01 Января 1999 г.

MMMMYYYY

(ММММГГГГ)

дата в виде месяц прописью ГГГГ

MMMMYY (ММММГГ)

дата в виде месяц прописью ГГ

ММММ (ММММ)

дата в виде месяц прописью

QQQQYYYY

(ККККГГГГ)

дата в виде N квартала ГГГГ

QQQQYY (ККККГГ)

дата в виде N квартала ГГ

QQQQ

дата в виде N квартала

YYYYMMDD

(ГГГГММДД)

дата в виде ГГГГММДД, то есть дата '10.11.1998' будет представлена как стро­ка "19981110"

WWWW (HHHH)

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

Пример:

ДолгКлиента = Строка(Формат(-Долг(), "Ч12.2")) + " " + Валюта.Сокр_назв;


Содержание раздела