Подробное описание. Нажмите чтобы развернуть
Форматная строка представляет собой строковое значение, включающее параметры форматирования.
Параметры форматирования перечисляются через символ “;”. Наличие параметра означает отличие форматирования от стандартного.
Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (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’ ,”ДП=””пустая дата”””) вернет строку “пустая дата”).
- БЛ – строка, представляющая логическое значение Ложь .
- БИ – строка, представляющая логическое значение Истина .
Параметры:
<Значение>
Форматируемое значение.
<ФорматнаяСтрока>
Форматная строка представляет собой строковое значение, включающее параметры форматирования.
Параметры форматирования перечисляются через символ ";". Наличие параметра означает отличие форматирования от стандартного.
Если параметр не задан, то применяется стандартное форматирование, которое в основном соответствует преобразованию значения к строке. Однако для значений типа Число и Дата по умолчанию (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" ,"ДП=""пустая дата""") вернет строку "пустая дата").
- БЛ - строка, представляющая логическое значение Ложь .
- БИ - строка, представляющая логическое значение Истина .
Основные типы данных в 1С – число, булево и дата, могут быть представлены множеством форматов. Программисты часто сталкиваются с тем, что требования к виду данных сильно различаются в разных отчетах и таблицах. Разработчики 1С подумали об удобстве программистов и создали специальную функцию, существенно облегчающую процесс изменения внешнего вида данных. Основная задача функции – привести число, дату или логический тип к нужному виду строкового типа.
Описание функции «Формат»
Синтаксис данной функции прост – в качестве параметров вы можете передать два параметра. Сначала разработчик указывает значение, которое должно подвергнуться форматированию. Чтобы 1С поняла, как нужно изменить значение, программист указывает второй параметр в виде строкового значения, содержащего предопределенные операнды. Именно значение этой строки и определяет, какими предстанут перед пользователями данные в отчете.
ОтформатированноеЗначение = Формат(ПеременнаяДляФорматирования,ТекстоваяФорматнаяСтрока);Если параметр «ФорматнаяСтрока» не задан, то 1С преобразует заданное значение в строку. Помните, что пустая дата и 0 будут преобразованы к пустой строке, что может не понравиться пользователям. Каждый параметр в форматной строке представляет собой комбинацию из наименования, символа «=» и значения, указываемого в кавычках. Это позволяет предусматривать вкрапление символов, используемых в написании форматной строки функции Формат в 1С.
В отображение данных вы можете вставить произвольный символ за исключением используемых в синтаксисе написания форматной строки. Если есть необходимость обойти это ограничение – используйте одинарные кавычки. Это решение также поможет в ситуациях, когда символ может быть истолкован компилятором неверно.
Для удобства разработчиков в 1С встроен конструктор форматной строки. К нему можно обратиться в модулях через контекстное меню или в СКД через предусмотренные разработчиками места. К примеру, такую возможность можно обнаружить в списке полей для запроса в разделе «Оформление».
Самое важное преимущество конструктора в том, что вы сразу же можете увидеть, как будут в итоге выглядеть ваши данные. После того как вы выставили необходимые настройки по конкретному типу данных в разделе «Пример», вам демонстрируют результат ваших установок. В безымянном текстовом поле внизу вы обнаружите форматную строку, с помощью которой получен результат. Ее можно скопировать и использовать в дальнейшем, если результат вас полностью устроит.
Конструктор форматной строки может стать отличным подспорьем начинающим разработчикам, но опытные программисты предпочитают не тратить время на него. Разработка пойдет намного быстрее, если вы будете знать основные ключевые параметры форматной строки и использовать их без вызова конструктора.
Основные параметры форматной строки
Изучить все доступные команды не получится, и в этом нет необходимости. Разработчику достаточно лишь знать некоторые популярные операции и как их применять. В любой момент вы сможете в синтакс-помощнике открыть полный перечень параметров форматной строки и выбрать нужный. Программисту 1С могут пригодиться в ежедневной работе следующие параметры:
- Л – формат страны, для представителей которой будут выводиться данные;
- ЧГ – задает группировку разрядов числа;
- ЧЦ – устанавливает общее количество групп символов целой и дробной части числа, которые будут выводиться на просмотр. Если в форматной строке с этим ключом не задано значение параметра ЧДЦ, то дробная часть не будет показана;
- ЧДЦ – параметр, задающий число символов в части числа после запятой. Округление происходит в соответствии со стандартными правилами математики;
- ЧС – параметр, сдвигающий разряды числа. Значение может быть положительным – умножение на 10, или отрицательным – деление. Полезная команда, если вам нужно вывести в одном виде, а продолжить работу с числом в другом;
- ЧРД – задает символ, разделяющий дробную и целую части числа. Чтобы установить символ, разделяющий группы целой части, используйте «ЧРГ». Для применения неразрывного пробела используйте пустую строку;
- ЧВН – показывает использование лидирующих нулей. Значение этого параметра не задается;
- ДФ – один из самых часто встречаемых параметров форматной строки. Управляет форматом даты. В 1С с помощью команды «Формат» можно вывести дату практически в любом формате, включая написание названия месяца. Возможных значений много, их перечень можно увидеть в синтакс-помощнике;
- БЛ и БИ – устанавливают представление для логического типа данных, отвечая, соответственно, за ложь и истину. Таким образом, стандартную «галочку» вы сможете заменить любым словом или фразой, более доходчивой для пользователей.
Универсализм и удобство конструктора стали ключевыми причинами популярности функции «Формат» среди разработчиков 1С. Гибкие настройки помогут вам задать любой внешний вид данным по желанию клиента.
*.cf - файл содержит только конфигурацию(код и структура) без пользовательских данных. Создаётся из конфигуратора 1С 8.х: «Конфигурация -> Сохранить конфигурацию в файл» или «Конфигурация -> Поставка конфигурации -> Создать файл поставки и обновление конфигурации -> признак «Создать файл поставки»».
*.cfu - файл содержит только обновление конфигурации. Например файл 1cv8.cfu. Создать конфигурацию из этого файла невозможно, так как он содержит в себе только отличия новой конфигурации от предыдущей. Создаётся из конфигуратора 1С 8.х: «Конфигурация -> Поставка конфигурации -> Создать файл поставки и обновление конфигурации -> признак «Создать файл обновления конфигурации»».
*.dt - файл содержит конфигурацию вместе с пользовательской базой данных. Это специализированный формат архива 1С 8. Создаётся из конфигуратора 1С 8.х: «Администрирование -> Выгрузить информационную базу».
*.epf (*.erf ) – файл внешней обработки (отчёта). Любую обработку (отчёт) из конфигурации можно сохранить внешней. Создаётся из конфигуратора 1С 8.х: «Конфигурация -> Открыть конфигурацию -> становимся на нужную обработку (отчёт) -> выделяем правой кнопкой мыши -> Сохранить как внешнюю обработку, отчёт…».
*.1cd – файл полноценной базы данных. Представление имени по умолчанию: 1Cv8.1CD. Включает в себя конфигурацию, базу данных, пользовательские настройки. Открывается платформой 1С 8.x. Создаётся для разработки новой конфигурации автоматически по кнопке «Добавить» при выборе пункта «Создание новой информационной базы».
*.log, *.lgf, *.lgp, *.elf - лог файлы, которые собирают информацию (регистрируют данные) в 1С 8.0 8.1, 8.2, 8.3.
*. cdn - файл с таким расширением (1Cv8.cdn) служит для ручной или автоматической блокировки базы данных 1С Предприятия восьмой версии .
*.mxl - файлы печатных форм используются, в том числе и в 1С. Являются как печатными формами документов, справочников, отчётов, так и различными накопителями данных для различных классификаторов. Открывается через Конфигуратор или в режиме 1С:Предприятии через «файл -> открыть». Создаётся точно так же: в режиме Конфигуратор или в 1С:Предприятии через «файл -> новый». Так же файлы с такими расширениями могут служить правилами переноса, например, из 1С 7.7 в 8.2 (acc77_82.xml и вспомогательная обработка exp77_82.ert) - находятся они обычно в папке ExtForms.
*.efd - это архивный файл 1С, используется для установки конфигурации. Содержит или конфигурацию 1с или обновление к ней. Запускается с помощью вспомогательного исполняющего файла setup.exe (должен находиться в одной папке).
*.mft – вспомогательный файл для создания конфигурации из шаблона. Содержит информацию о конфигурации, описание, пути, название. Используется непосредственно самой платформой при создании информационной базы 1С из шаблона.
*.grs - файлы графических схем в специализированном формате 1С. Открывается через Конфигуратор или в режиме 1С:Предприятии через «файл -> открыть». Создаётся точно так же: в режиме Конфигуратор или в 1С:Предприятии через «файл -> новый».
*.geo - файлы географических схем в специализированном формате 1С. Открывается через Конфигуратор или в режиме 1С:Предприятии через «файл -> открыть». Создаётся точно так же: в режиме Конфигуратор или в 1С:Предприятии через «файл -> новый».
*.st - файлы шаблонов текстов. Используются в основном 1С разработчиками.
*.pff - файл с сохраненными замерами производительности. Используются системными администраторами и специалистами 1С.