К статье
Практический материал

Другое · 5 мин

Как из даты получить часы в 1С: пошаговая инструкция

Практическая инструкция: как из даты и даты-времени в 1С извлечь часы, проверить результат и избежать типичных ошибок при работе с типом Дата.

В 1С:Предприятие значение типа Дата может содержать только календарную дату или дату вместе со временем. Если нужно получить часы из даты, сначала уточните, есть ли в исходном значении временная часть, и в каком виде результат должен использоваться: число, строка или часть отчёта.

Язык 1С предоставляет встроенные функции для работы с датой и временем, но они не создают время там, где его не было. Поэтому основной риск — получить неожидаемый ноль или пустую строку, если источник содержит только дату без времени.

Ниже описан порядок действий, способы проверки и ситуации, когда независимые изменения в коде могут быть небезопасными.

Что нужно знать перед извлечением часов

Функция Час работает со значением типа Дата и возвращает часовую составляющую. Если значение имеет тип Дата, но время не заполнено, поведение зависит от того, как платформа интерпретирует такое значение в конкретном контексте.

Перед изменением кода убедитесь, откуда берётся исходное значение: из документа, регистра, справочника или пользовательского ввода. Разные источники могут хранить дату и время по-разному, даже если внешне форма одинакова.

Только датаВремя не задано

Проверьте, заполнена ли временная часть перед расчётом

Дата и времяЕсть временная часть

Можно извлекать час функцией Час

Неизвестный источникТип значения неочевиден

Уточните тип поля в конфигурации или отладчике

Разница между датой и датой-временем в 1С

Если в значении только дата

Когда источник хранит только календарную дату, временная часть отсутствует или считается пустой. Попытка получить часы из такого значения может не дать смысла для анализа, так как нет основания говорить о конкретном часе суток.

Если в значении дата и время

Если значение включает дату и время, функция Час извлекает часовую часть из этого момента. Это подходит для отчётов по сменам, времени создания документов и других задач, где важен именно час суток.

Порядок действий
  1. 1
    Определите источник значения типа Дата
  2. 2
    Убедитесь, что в значении есть временная часть
  3. 3
    Примените функцию Час к исходному значению
  4. 4
    При необходимости оформите результат как строку
  5. 5
    Проверьте результат на нескольких примерах данных

Как получить часы функцией Час

Для извлечения часов используйте вызов функции Час с аргументом типа Дата. Результат может использоваться в вычисляемых полях, отборах и выражениях отчётов.

ЧасЗначения = Час(МояДата);

Если требуется получить текстовое представление с ведущим нулём, преобразуйте число в строку с нужным форматом. Порядок преобразования зависит от того, где будет выводиться результат: в форме, печатной форме или программном коде.

Как вывести часы в нужном формате

Число часов можно оставить числом для расчётов или превратить в строку для отображения. Для отчётов удобнее использовать форматирование, которое делает вывод единообразным для всех записей.

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

Типичные ошибки
01
Извлечение часов из значения без временной части приводит к неожидаемому результату
02
Применение функции к строке или неопределённому значению вызывает ошибку выполнения
03
Использование часа без проверки часового контекста может исказить отчёт

Проверка результата и типичные ошибки

Проверяйте полученное значение на нескольких записях с разным временем суток. Если часы постоянно равны одному и тому же значению, возможно, источник содержит только дату или время было обнулено при импорте.

Частая ошибка — применять функцию Час к значению, которое на самом деле является строкой или неопределённым значением. Это может привести к ошибке выполнения или некорректному результату без явного сообщения.

Когда лучше не править код самостоятельно

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

Также не меняйте логику расчёта времени, если результаты используются для начислений, отчётности или документов с юридической значимостью, без согласования с ответственными сотрудниками.

Итог

Что важно запомнить

Получайте часы функцией Час только из значений с временной частью, проверяйте тип источника и не меняйте общую логику без согласования.

Нужно ли преобразовывать дату перед вызовом Час?

Если значение уже имеет тип Дата, дополнительное преобразование не требуется. Если это строка, сначала преобразуйте её в дату средствами платформы, и только потом извлекайте часы.

Что делать, если часы всегда равны нулю?

Проверьте, содержит ли исходное значение временную часть. Если в базе хранится только дата, часовой составляющей нет, и нулевой результат может быть ожидаемым.

Можно ли использовать Час в отборе отчёта?

Да, результат функции Час можно использовать в отборе, если отчёт поддерживает вычисляемые поля и тип данных совместим с условием отбора.

Безопасно ли менять код в конфигурации самостоятельно?

Безопасно только в пользовательских модулях и при наличии резервной копии. Изменение общих модулей и закрытой конфигурации требует участия разработчика или администратора.

Нужно ли учитывать часовой пояс?

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