1C-Code → Основы 1С → Даты: границы периода и потерянный последний день

Даты: границы периода и потерянный последний день

Тип, на котором ошибаются чаще всего. Здесь — почему отчёт теряет последний день и как это не повторить.

Глава 7 из 36 · чтение примерно 26 минут

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

Эту главу стоит прочесть внимательно даже опытному: ошибка «отчёт теряет последний день периода» живёт в рабочих базах годами и обнаруживается случайно.

Как записать дату

Дата(2024, 3, 7) — год, месяц, день. Именно в этом порядке, от большего к меньшему.

Можно добавить время: Дата(2024, 3, 7, 14, 30, 0) — часы, минуты, секунды. Если время не указано, оно равно полуночи — ноль часов ноль минут. Запомните это: полночь — это начало дня, а не конец.

Дата — это момент

Дата(2024, 3, 7);              // 07.03.2024 00:00:00
Дата(2024, 3, 7, 14, 30, 0);   // 07.03.2024 14:30:00
Дата(2024, 13, 1);             // ОШИБКА: тринадцатого месяца нет

Границы периода: главная ошибка учёта

Пусть отчёт строят за март. Пишут отбор: Дата >= Дата(2024,3,1) И Дата <= Дата(2024,3,31). Выглядит безупречно — и теряет весь последний день.

Потому что Дата(2024,3,31) — это 31 марта в полночь, то есть самое начало 31-го. Документ, проведённый 31 марта в 10 утра, имеет время 10:00 — он больше, чем полночь, и в отбор не попадает.

Отбор.Установить(
  Дата <= Дата(2024, 3, 31));

// 31.03 00:00:00
// всё, что позже полуночи, — мимо

Отбор.Установить(
  Дата <= КонецДня(Дата(2024, 3, 31)));

// 31.03 23:59:59
// последний день целиком внутри

Границы периодов

Разобрать дату на части

Год(Д), Месяц(Д), День(Д) возвращают числа. Час, Минута, Секунда — время.

ДеньНедели(Д) даёт номер, где понедельник = 1, воскресенье = 7. Это отличается от многих языков, где неделя начинается с воскресенья, — и от этого зависит, попадёт ли ваш отчёт по будням на правильные дни.

Сдвиг на месяцы: ДобавитьМесяц

Прибавить месяц — это не прибавить 30 дней. В месяцах разное число дней, поэтому для сдвига есть отдельная команда: ДобавитьМесяц(Дата, Сколько).

Она умеет главное: прижимать к концу месяца. 31 января плюс месяц — это 29 февраля в високосный год и 28 февраля в обычный. Не «2 марта», как вышло бы при прибавлении 31 дня.

Прижатие к последнему дню

ДобавитьМесяц(Дата(2024,1,31), 1);   // 29.02.2024 — високосный
ДобавитьМесяц(Дата(2023,1,31), 1);   // 28.02.2023 — обычный
ДобавитьМесяц(Дата(2024,3,31), 1);   // 30.04.2024 — в апреле 30 дней
ДобавитьМесяц(Дата(2024,3,31), -1);  // 29.02.2024 — назад тоже можно

Пустая дата

Дата, которую не заполнили, не равна Неопределено. У неё есть своё значение — 01.01.0001, самое начало летоисчисления.

Проверять её сравнением с этой датой неудобно и легко ошибиться. Для этого есть ЗначениеЗаполнено(Д) — она вернёт Ложь для пустой даты и Истину для любой настоящей.

Проверять дату до вычислений обязательно: разность с пустой датой даст около семисот тысяч дней, и это число молча уедет в отчёт как «срок хранения».

Показать дату человеку

Формат(Дата, "ДФ=dd.MM.yyyy") превращает дату в текст по шаблону: dd — день, MM — месяц, yyyy — год, HH:mm:ss — время.

И правило, которое важнее самого шаблона: Формат нужен только для показа. Хранить, сравнивать и складывать надо настоящие даты. Дата, превращённая в строку, сортируется как текст — и 01.12.2024 окажется раньше, чем 05.03.2024.

Разница дат — это секунды

Даты вычитаются: Дата2 - Дата1 даёт число секунд между ними. Не дней и не часов — секунд, потому что внутри дата и есть секунды.

Отсюда набор делителей, который приходится помнить: 60 — минута, 3600 — час, 86400 — сутки. Последнее число узнаётся в 1С раньше любого другого.

Прибавление работает так же: Дата + 86400 — завтра, Дата - 3600 — час назад. Только с месяцами так нельзя: в месяце не постоянное число секунд, и для них есть ДобавитьМесяц.

Сравнение дат и попадание в период

Даты сравниваются обычными знаками: <, >, =. Раньше — значит меньше.

А вот «попадает ли дата в период» — то место, где ошибка из начала главы возвращается. Условие Дата <= КонецПериода отсекает всё, что случилось в последний день после полуночи, если КонецПериода — это дата без времени.

Правильно — сравнивать с КонецДня(КонецПериода). И то же самое в запросе: параметр &КонецПериода заполняют уже приведённым к концу дня, а не «как выбрали в форме».

Какая сейчас дата

Команд две, и разница между ними — частый вопрос на собеседовании.

ТекущаяДата() возвращает время того компьютера, где выполняется код. На сервере — серверное, на клиенте — клиентское. В управляемом приложении на клиенте её вызывать нельзя.

ТекущаяДатаСеанса() возвращает время сеанса — серверное, с учётом часового пояса сеанса. Это правильный способ, и в типовых пишут именно так.

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

Даты в запросе

В тексте запроса даты не пишут. Их передают параметром: Запрос.УстановитьПараметр("НачалоПериода", НачалоДня(Начало)).

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

У языка запросов есть свои функции для дат, и они повторяют знакомые: НАЧАЛОПЕРИОДА(Дата, ДЕНЬ), КОНЕЦПЕРИОДА(Дата, МЕСЯЦ), ДОБАВИТЬКДАТЕ(Дата, ДЕНЬ, 7), РАЗНОСТЬДАТ(Дата1, Дата2, ДЕНЬ). Пригодятся, когда группировать надо по месяцам, а дата в данных — с временем.

Шпаргалка по датам

Что дальше

Три базовых типа разобраны: число, строка, дата. Дальше — условия и циклы: как программа выбирает путь и повторяет действия. После них код перестаёт быть прямой линией.

Как закрепить

Читать про код и писать код — разные умения. В тренажёре к этой главе идут упражнения: вы пишете решение, оно запускается на настоящем интерпретаторе 1С и проверяется сразу, без установки платформы.

Открыть эту главу в тренажёре

← Строки: склеить, разрезать, найти, проверить
→ Условия: Булево и выбор пути