Файл скачан сегодня, но документ внутри него датирован несколько лет назад. Здесь нет противоречия: дата документа, дата среза источника и момент вашей выгрузки отвечают на разные вопросы. Ошибка начинается, когда одну из них подписывают общим словом «актуальность».
Ниже — способ сохранить эти различия рядом с результатом и объяснить их следующему человеку, который будет читать файл.
Дайте каждой дате собственный смысл
Дата документа — дата, которую источник относит к самому документу: например, дата его составления. Уточните название поля и его определение. Дата составления, публикации и изменения документа не обязаны совпадать.
Дата среза источника — дата состояния набора, если поставщик именно так определил срез. Она не равна автоматически дате каждого факта внутри. Проверьте, относится ли обозначение к состоянию реестра, публикации файла или только к обновлению описания на сайте.
Момент выгрузки — когда вы получили или сформировали конкретную копию. Он нужен для воспроизводимости ваших действий. Он не делает старый документ новым и не подтверждает, что источник обновлялся непосредственно перед скачиванием.
В модели описания данных W3C DCAT 3 отдельно определены выпуск ресурса, его изменение и период, который покрывает набор. Дата изменения каталожной записи также отличается от даты изменения самого ресурса. Это полезный ориентир для чтения метаданных, а не требование переименовать все поля ваших файлов в термины DCAT.
Сохраните три значения рядом
Предположим, документ составлен 14 мая 2020 года, включён в обозначенный источником срез от 20 октября 2026 года, а вы выгрузили копию 25 октября. Учебная запись может выглядеть так:
{
"example": "synthetic record; not a service response",
"document_id": "DEMO-DOC-01",
"document_date": "2020-05-14",
"source_snapshot_date": "2026-10-20",
"exported_at": "2026-10-25T09:00:00+00:00"
}
Это синтетический пример, не ответ API и не описание реально полученного документа. Имена полей выбраны для объяснения; они не объявлены полями продуктов Atomno. Смещение +00:00 в примере явно задаёт время относительно UTC. У календарной даты документа нет выдуманного времени суток.
Из такой записи можно прочитать заявленные даты документа, среза и вашей копии. Нельзя сделать вывод, что документ был впервые опубликован в день среза, что все сведения проверены 25 октября или что источник содержит каждый документ за этот период.
Рядом с файлом сохраните, откуда взято каждое значение: описание поля, обозначение выпуска или ваш журнал выгрузки. Для даты среза особенно важно сохранить формулировку поставщика. Самостоятельно вычисленная самая поздняя дата документа в файле не заменяет это определение.
Не заполняйте неизвестную дату сегодняшним числом
Если дата среза не установлена, честнее оставить это различие видимым:
{
"example": "synthetic record; not a service response",
"document_id": "DEMO-DOC-01",
"document_date": "2020-05-14",
"source_snapshot_date": null,
"exported_at": "2026-10-25T10:00:00+00:00"
}
В этой учебной договорённости null означает только «дата среза не установлена». Момент выгрузки известен отдельно. Новый час получения файла не отвечает на вопрос, к какому состоянию источника относятся данные.
Не переносите эту трактовку null в чужой формат без его описания. Если поставщик использует отдельный статус, подпись или файл метаданных, сохраните соответствующее обозначение и его смысл.
При повторной выгрузке сравните версии
Через неделю вы можете получить ту же версию источника ещё раз. Изменится время вашего получения, но это само по себе не новая версия данных. Сохраните обозначение выпуска или версии, если оно есть, и не перезаписывайте первую копию только потому, что у новой более поздняя дата скачивания.
Если версия изменилась, выясните, что именно обновляли: состав набора, значения записей, описание полей или только страницу каталога. В DCAT 3, свойство даты изменения относится к изменению соответствующего ресурса; дата каталожного описания имеет отдельный смысл. Более свежая подпись на странице не доказывает обновление всех записей.
Для повторного анализа отметьте, какую копию вы использовали и по какому правилу выбирали документы. Например, фильтр по дате документа и выбор источника за определённый срез — разные условия. Один не подменяет другой.
Передайте результат с понятной подписью
Вместо «данные актуальны на сегодня» дайте короткую проверяемую подпись: «Документ от 14.05.2020; источник обозначил срез 20.10.2026; копия выгружена 25.10.2026 в 09:00 UTC». Если дата среза неизвестна, напишите это прямо.
Перед передачей проверьте:
- Для каждой даты понятно, к документу, набору, каталожному описанию или вашей копии она относится.
- Известен источник значения; неизвестные даты не заполнены предположениями.
- Для времени выгрузки указано смещение или согласованный часовой пояс.
- Сохранены версия и копия, на которых основан результат, если они доступны.
- Подпись не обещает полноту набора, свежесть каждого факта или проверку его содержания.
Сверить названия полей и определения конкретного продукта можно в документации данных. Такой переход нужен после разбора дат: общий пример помогает задать точный вопрос, но не назначает смысл поля в чужом контракте.


