Работа с временными метками в конфигурациях на платформе 1С:Предприятие 8 является фундаментальной задачей для любого разработчика или администратора системы. Пользователи часто сталкиваются с необходимостью отобразить точное время создания документа, зафиксировать момент проведения операции или настроить автоматическое выполнение задач по расписанию. Однако тип данных Дата в 1С обладает своей спецификой, отличной от привычных представлений в других языках программирования или офисных приложениях.
В этой статье мы разберем, как корректно получить текущее время, как разделить дату и время для отдельных полей и как правильно форматировать вывод для печатных форм. Особое внимание уделим различиям между системным временем компьютера пользователя и временем сервера, так как эта деталь часто становится причиной ошибок в распределенных базах данных.
Понимание механики работы со временем позволит вам избежать ситуаций, когда документы «улетают» в прошлое или будущее из-за неверных настроек часов на клиентских машинах. Мы рассмотрим как встроенные функции языка запросов, так и методы глобального контекста, доступные в управляемых формах.
Основы типа данных Дата и получение текущего момента
В платформе 1С:Предприятие 8 не существует отдельного типа данных «Время». Все временные значения хранятся в едином типе Дата, который включает в себя и календарную дату, и время с точностью до секунды. Чтобы получить актуальный момент «здесь и сейчас», разработчики используют функцию ТекущаяДата(). Эта функция возвращает значение типа Дата, содержащее текущие показания системных часов.
Критически важно понимать, откуда именно берется это время. В файловом варианте работы базы 1С функция возвращает время локального компьютера пользователя. Однако в клиент-серверном варианте (SQL) поведение зависит от контекста выполнения кода. Если код выполняется на стороне клиента (в форме), вы получите время ПК пользователя. Если же код выполняется на сервере (в модуле объекта или общем модуле с признаком «Сервер»), вы получите время сервера 1С или сервера баз данных.
⚠️ Внимание: В распределенных информационных базах время на рабочих местах пользователей может сильно отличаться от времени сервера из-за разных часовых поясов или сбитых настроек BIOS. Никогда не полагайтесь на время клиента для критически важных бизнес-процессов, таких как расчет зарплаты или закрытие периода.
Для получения времени именно сервера, независимо от того, где запущен код, следует использовать функцию ТекущаяДатаСеанса() или обращаться к системным таблицам через запрос. Это гарантирует консистентность данных во всей системе. Ниже приведен пример кода, демонстрирующий разницу:
// Получение времени клиента (локальное)
ВремяКлиента = ТекущаяДата();
// Получение времени сеанса (серверное)
ВремяСервера = ТекущаяДатаСеанса();
Сообщить("Клиент: " + ВремяКлиента);
Сообщить("Сервер: " + ВремяСервера);
Если вам нужно время именно сервера базы данных (SQL), используйте запрос: "ВЫБРАТЬ ТЕКУЩЕДАТА() КАК ВремяИзБД". Это исключит влияние настроек службы 1С:Предприятие.
Разделение даты и времени: работа с составными частями
Часто в интерфейсе программы требуется вывести дату в одно поле, а время (часы, минуты) — в другое. Например, в журнале документов дата может быть в одной колонке, а время проведения — в соседней. Для решения этой задачи в языке 1С предусмотрены специальные функции извлечения компонентов: Год(), Месяц(), День(), Час(), Минута() и Секунда().
Функция Час() возвращает целое число от 0 до 23, соответствующее часу в сутках. Аналогично работают функции для минут и секунд. Это позволяет легко манипулировать временными отрезками или строить условия отбора. Например, можно выбрать все документы, проведенные в первой половине дня.
- 🕒 Функция
Час(Дата)вернет числовое значение часа (например, 14 для 14:30). - 📅 Функция
НачалоДня(Дата)обнулит время, оставив только дату (14:30 превратится в 00:00). - ⏱️ Функция
КонецДня(Дата)установит время на 23:59:59, что удобно для периодов отчета.
Если необходимо сконструировать дату из отдельных компонентов, используется функция Дата(). Она принимает год, месяц, день и опционально час, минуту, секунду. Это полезно при импорте данных из внешних систем, где дата и время приходят раздельными строками или числами.
// Сборка даты из компонентов
ГодТек = 2023;
МесяцТек = 12;
ДеньТек = 31;
ЧасТек = 23;
МинутаТек = 59;
НоваяДата = Дата(ГодТек, МесяцТек, ДеньТек, ЧасТек, МинутаТек);
☑️ Проверка корректности времени
Форматирование времени для вывода в печатных формах
При выводе времени в отчеты, печатные формы или на экран пользователю «сырое» значение типа Дата часто выглядит неудобно (например, содержит лишние нули или неправильный разделитель). Для красивого отображения используется функция Формат(). Она позволяет задать строку формата, определяющую, какие компоненты даты и в каком виде будут показаны.
Строка формата состоит из описателей, разделенных точкой с запятой. Для вывода только времени используются описаторы ЧН (Час), МН (Минута), СН (Секунда). Можно также использовать готовые стандартные форматы, такие как ДФ="HH:mm", если настроена локаль, но явное указание компонентов надежнее.
| Описатель формата | Пример значения | Результат вывода |
|---|---|---|
ЧН=2; МН=2 |
14:05 | 14:05 |
ЧН=2; МН=2; СН=2 |
09:30:15 | 09:30:15 |
ДФ="HH:mm:ss" |
23:59:59 | 23:59:59 |
ЧН=2; МН=2; ДН="ам/пм" |
14:00 | 02:00 пп |
Использование параметра МН=2 гарантирует, что минута всегда будет двузначной (05 вместо 5). Это критично для выравнивания колонок в табличных документах. Если время не требуется, его можно полностью исключить из строки формата, оставив только дату.
⚠️ Внимание: Форматирование влияет только на отображение. Внутреннее хранение значения в переменной остается неизменным (полная дата и время). Не пытайтесь «обрезать» время через форматирование для последующих вычислений — для этого используйте функцию
НачалоДня().
Отображение часов в управляемых формах и элементах интерфейса
При проектировании интерфейса в режиме Управляемое приложение разработчики часто размещают поля ввода даты. По умолчанию такие поля могут показывать только дату, скрывая время, что неудобно для оперативного учета. Чтобы сделать часы видимыми для пользователя, необходимо настроить свойства элемента формы.
В свойствах поля ввода типа Дата есть параметр «Вид даты». Изменив его значение на ДатаВремя, вы позволите пользователю вводить и видеть часы и минуты. Если выбрать значение Дата, время будет скрыто, хотя внутри объекта оно сохранится (обычно обнуляется до 00:00 при сохранении, если не указано иное).
Для отображения текущего времени в декоративных целях (например, в шапке формы «Текущее время: 14:35») нельзя просто привязать поле к переменной, так как оно не будет обновляться само по себе. Необходимо использовать таймер формы. Событие ПриСрабатыванииТаймера() должно обновлять значение поля вывода каждые несколько секунд или минут.
&НаКлиенте
Процедура ТаймерФормыПриСрабатыванииТаймера(Элемент)
// Обновляем поле вывода времени
Элементы.ПолеВыводВремени.Текст = Формат(ТекущаяДата(), "ЧН=2; МН=2");
КонецПроцедуры
Важно помнить о производительности. Запуск таймера с интервалом в 1 секунду для обновления часов может создавать лишнюю нагрузку на клиентское приложение, если форм много. Оптимальным интервалом для обычных задач является 30 или 60 секунд.
Почему время сбрасывается при сохранении?
Если в свойствах поля формы установлен «Вид даты» = Дата, то при записи объекта в базу 1С автоматически обнуляет время до 00:00:00. Чтобы сохранить время, измените свойство на ДатаВремя.
Работа с часовыми поясами и конвертация времени
В современных версиях платформы 1С:Предприятие 8 (начиная с 8.3.10) появилась полноценная поддержка часовых поясов. Это особенно актуально для компаний с филиалами в разных регионах или для работы с международными партнерами. Тип ДатаВЧасовомПоясе позволяет хранить момент времени с привязкой к конкретной географической зоне.
Конвертация между локальным временем и временем UTC (всемирное координированное время) выполняется специальными функциями. Это позволяет избегать ошибок, когда сервер находится в Москве, а пользователь работает из Владивостока. Без учета поясов документ, созданный в 10:00 по местному времени пользователя, на сервере может записаться как 03:00 или 17:00 в зависимости от настроек.
- 🌍 Функция
ПолучитьЧасовойПояс()возвращает объект часового пояса по имени (например, "Etc/GMT-3"). - 🔄 Функция
ПеревестиВЧасовойПояс()выполняет непосредственный сдвиг времени. - ⚙️ Свойство
ЧасовойПоясСеансасодержит настройки текущего пользователя.
При выводе времени в печатные формы для разногородских офисов рекомендуется явно указывать часовой пояс рядом со значением времени. Это снимает вопросы у бухгалтеров и логистов о том, в каком времени зафиксировано событие. Игнорирование этого аспекта может привести к путанице при аудите логов системы.
Всегда храните в базе время в формате UTC или времени сервера, а конвертируйте в локальное время пользователя только в момент отображения в интерфейсе или отчете.
Автоматизация по времени: регламентные задания и таймеры
Одной из самых мощных возможностей работы со временем в 1С является автоматизация процессов. Регламентные задания позволяют запускать код по расписанию: каждую ночь, каждый час или в конкретную минуту. Это используется для обновления курсов валют, расчета себестоимости или рассылки уведомлений.
Для настройки такого задания в консоли администрирования 1С указывается расписание в формате, похожем на Cron, но более понятном пользователю. Можно задать интервал повторения или конкретное время суток. Важно учитывать, что задание выполняется на стороне сервера, поэтому все временные логики внутри него должны опираться на серверное время.
Внутри кода обработки регламентного задания часто требуется проверить, не вышло ли время выполнения за допустимые пределы, чтобы не блокировать работу пользователей в часы пик. Для этого сравнивают ТекущаяДатаСеанса() с заранее заданными границами рабочего дня.
⚠️ Внимание: При настройке регламентных заданий учитывайте переход на летнее/зимнее время в регионе сервера, если автоматический перевод не настроен в ОС. Сдвиг на час может привести к тому, что отчеты сформируются на час раньше или позже запланированного.
Также в коде можно реализовать собственную логику ожидания. Хотя функция Ждать() существует, использовать её в основном потоке приложения категорически не рекомендуется, так как она «замораживает» интерфейс для пользователя. Для фоновых процессов лучше использовать асинхронные механизмы или отдельные фоновые задания.
Как вывести только часы и минуты без секунд?
Используйте функцию Формат с параметрами "ЧН=2; МН=2". Это скроет секунды при отображении, но не удалит их из самого значения даты.
Почему время в базе отличается от времени на моих часах?
Скорее всего, вы работаете в клиент-серверном варианте, и код выполняется на сервере, время которого может отличаться от вашего локального ПК. Проверьте настройки часового пояса сервера.
Можно ли запретить пользователям проводить документы задним числом?
Да, это делается программно в модуле объекта. Сравнивайте дату документа с ТекущаяДатаСеанса() и выдавайте сообщение об ошибке, если дата раньше начала текущего дня.
Как получить время с миллисекундами в 1С?
Стандартными средствами типа Дата точность ограничена секундами. Для получения миллисекунд необходимо использовать внешние компоненты или специфические вызовы к системным библиотекам Windows/Linux через COM или Native API, что редко требуется в типовых задачах.
Влияет ли смена часового пояса Windows на работу 1С?
Да, влияет. Если на сервере изменится часовой пояс, все новые записи будут создаваться со сдвигом. Существующие записи (хранящиеся как абсолютное время) при отображении могут сдвинуться для пользователей, если система настроена на автоматическую конвертацию.