Другое · 7 мин
Как получить сегодняшнюю дату в 1С
Практическая инструкция: как в 1С:Предприятии получить текущую дату, убрать время, использовать в запросах и документах, избежать ошибок с часовыми поясами.
В конфигурациях на платформе 1С:Предприятие текущую дату возвращает встроенная функция ТекущаяДата(). Она относится к глобальному контексту и доступна из большинства модулей: форм документов, отчетов, обработок и серверных процедур. Результат имеет тип Дата и содержит не только календарный день, месяц и год, но и точное время до секунд.
Чаще всего функция нужна, чтобы автоматически заполнить реквизит Дата при создании документа, установить период отчета или отфильтровать записи за текущий день. Важно понимать, что возвращаемое значение зависит от того, где выполняется код: на клиентском компьютере или на сервере приложения. Это влияет на часовой пояс и точность при работе с распределенными базами.
Простейший способ получить сегодняшнюю дату — вызвать функцию без параметров. В модуле формы документа это может выглядеть так: Дата = ТекущаяДата();. После этого переменная Дата содержит текущий момент времени, и её можно присвоить реквизиту объекта или передать в процедуру.
Если в дальнейшем дата используется для сравнения «сегодня» с датами в регистрах или табличной части, время может мешать. Две записи, созданные в разное время одного дня, не будут считаться равными, если сравнивать полные значения типа Дата. Поэтому для календарного сравнения лучше работать с началом дня.
Получение даты без времени: начало дня
Чтобы оставить только календарную дату, используйте функцию НачалоДня(), передав в неё результат ТекущаяДата(). Выражение НачалоДня(ТекущаяДата()) возвращает ту же дату, но время обнуляется до 00:00:00. Это удобно для фильтрации, группировки и сравнения записей за сегодняшний день без привязки к часу создания.
Пример в коде: Сегодня = НачалоДня(ТекущаяДата());. Полученное значение можно сохранить в переменную или передать в запрос в качестве параметра. Если нужно работать с конкретным моментом, включая время, используйте необработанный результат ТекущаяДата() без обрезки.
- 1Откройте модуль формы или общего модуля, где нужна дата
- 2Вызовите функцию ТекущаяДата() и присвойте результат переменной
- 3Если нужно сравнивать только по дням, оберните вызов в НачалоДня()
- 4Запишите значение в реквизит документа или передайте в запрос
- 5Проверьте, что в реквизите попала дата без лишнего времени
Клиент, сервер и часовые пояса
Функция ТекущаяДата() возвращает время того компьютера, на котором выполняется код. На клиенте это локальное время пользователя, а на сервере — время сервера приложения. При работе в распределенной информационной базе или с терминальным доступом разница может быть существенной, особенно если пользователи находятся в разных часовых поясах.
Для критичных к времени операций, таких как закрытие периода или проведение документов, уточняйте, где будет выполняться процедура. Серверные вызовы выполняются на стороне сервера, клиентские — на рабочей станции. Если точность до секунды не важна, разница обычно не влияет на учет, но при сверке по времени лучше явно указывать контекст выполнения.
Сравнение вариантов
Подходит, когда нужно время создания или полный момент
Подходит для сравнения по дням, фильтрации и отчетов без времени
Использование текущей даты в запросах и отчетах
Язык запросов 1С не содержит прямого аналога ТекущаяДата(), который можно вызвать внутри текста запроса. Поэтому значение передают через параметр. В коде формируют параметр, например &ТекущаяДата, присваивают ему результат ТекущаяДата() или НачалоДня(ТекущаяДата()), а затем подставляют в условие отбора.
Пример логики: выбрать документы, где Дата между началом сегодняшнего дня и началом следующего. Для этого вычисляют границы: начало дня и начало следующего дня, передают оба значения в запрос. Такой подход гарантирует попадание всех записей за сутки независимо от времени их создания.
Запись текущей даты в документ и регистр
При создании нового документа реквизит Дата часто заполняется автоматически, но в некоторых обработках требуется явное присвоение. Используйте конструкцию Объект.Дата = ТекущаяДата(); перед записью. Если документ должен иметь дату без времени, примените НачалоДня(ТекущаяДата()).
При записи в регистры накопления или бухгалтерии дата движения обычно берется из документа. Явно подставлять текущую дату в регистр напрямую стоит только в специальных обработках и с осторожностью, так как это может нарушить хронологию движений и привести к ошибкам при закрытии периода.
Частые ошибки и как их избежать
Одна из типичных ошибок — сравнение полных значений типа Дата, когда нужно сравнить только календарные дни. Из-за разницы в часах, минутах и секундах записи за один день могут не совпасть. Решение: использовать НачалоДня() с обеих сторон сравнения или задавать диапазон от начала дня до начала следующего.
Другая ошибка — зависимость от клиентского времени в серверной логике. Если пользователь изменил системные часы на рабочем станции, клиентская функция может вернуть некорректное значение. Для критических операций предпочтительно проверять источник времени и, при необходимости, опираться на серверную дату.
Как проверить результат
Соответствует текущему календарному дню
Дата другого дня или время не обнулено, хотя нужно только число
Возвращаются записи только за сегодня
Попадают записи за другие дни или отсутствуют записи за сегодня
Проверка результата и границы самостоятельной работы
После заполнения реквизита откройте документ в форме и убедитесь, что в поле Дата отображается ожидаемый день. Если время не нужно, убедитесь, что оно равно нулю или отсутствует в отображении. В запросе проверьте, что отбор возвращает записи только за текущий календарный день, а не за произвольный интервал.
Самостоятельно можно править модули форм, общие модули и отчеты в рамках своих прав доступа. Изменения в конфигурации, особенно в стандартных объектах, лучше вносить через расширение конфигурации и после создания резервной копии. Если не уверены в влиянии на закрытие периода, обратитесь к администратору системы или ответственному за 1С сотруднику.
Что важно запомнить
Сегодняшнюю дату в 1С берут через ТекущаяДата(), а для сравнения по календарным дням обрезают время через НачалоДня(); учитывайте разницу между клиентом и сервером.
Можно ли получить только дату без времени?
Да, для этого оберните вызов ТекущаяДата() в функцию НачалоДня(). Результат будет содержать календарную дату с нулевым временем, что удобно для отбора записей за сегодня.
Работает ли ТекущаяДата() в запросе напрямую?
Нет, внутри текста запроса эту функцию вызвать нельзя. Значение передают через параметр запроса, заранее вычислив его в коде на языке 1С.
Что делать, если дата в документе не совпадает с ожидаемой?
Проверьте, где выполнялся код: на клиенте или сервере, и какой часовой пояс используется. Также убедитесь, что время не обрезано или, наоборот, не оставлено там, где нужно только число.
Безопасно ли присваивать текущую дату реквизиту документа вручную?
В обычных ситуациях да, если у вас есть права на редактирование документа. В закрытых периодах или при массовой записи в регистры лучше согласовать действие с администратором, чтобы не нарушить хронологию движений.