Строка 03/04/2026 сама по себе не сообщает, идёт ли сначала день или месяц. Не отдавайте такой выбор системной локали сервера. Сохраните исходный текст, установите правило конкретного типа документа и только затем получайте нормализованную дату. Если правило неизвестно, нужен явный статус неоднозначности.
Три значения выполняют разные задачи
Условный результат извлечения:
raw_text: 03/04/2026
format_context: day/month/year, подтверждён для шаблона
parsed_date: 2026-04-03
status: accepted
source: страница и область
display: формат интерфейса, не новый разбор raw_textВ примере порядок дня и месяца задан специально; это не рекомендация разбирать любой slash-формат таким способом. Храните источник контекста: версию шаблона, настройку поставщика документа или подтверждение оператора. Язык интерфейса читателя не определяет формат чужого исходного документа.
Google Document AI различает mentionText и normalizedValue. В схеме Document нормализованное значение может отсутствовать; dateValue содержит календарную дату, а datetimeValue — дату и время. Документация проверена 25 октября 2026 года. Не считайте отсутствие normalizedValue пустым исходным полем и не обещайте его наличие для любого processor или типа документа.
Неоднозначность и невозможная дата — разные исходы
| Искусственная строка | Что проверять |
|---|---|
| 03/04/2026 | Неоднозначный порядок компонентов |
| 31.02.2026 | Невозможный календарный день |
| 29.02.2024 | Допустимую високосную дату |
| 04/2026 | Частичную дату без дня |
| 2026-04-03 23:30 | Наличие времени и его отдельного контекста |
Валидатор должен проверять календарную допустимость после разбора, а не только наличие цифр и разделителей. Частичную дату нельзя незаметно дополнять первым числом, если это не согласованное правило продукта. Отдельно различайте пустое поле, нераспознанное значение и значение, отправленное на ручную проверку.
Не превращайте дату без времени в случайную полночь с часовым поясом сервера ради удобства базы. Это может сдвинуть календарный день при отображении в другой зоне. Если бизнес-поле действительно означает момент события, для него нужен отдельный контракт времени и зоны. Поле «дата документа» часто имеет другой смысл.
Формат интерфейса не должен менять сохранённый смысл
Показывайте одну принятую дату в нужной локали без повторного угадывания исходной строки при каждом открытии. Импорт и экспорт используют явно согласованные форматы. Если выгрузка должна сохранить исходное написание, передавайте его отдельным полем, а не заменяйте нормализованную дату текстом из интерфейса.
- Собрать искусственные однозначные и неоднозначные даты.
- Прогнать их при разных локалях окружения.
- Сверить неизменность принятой календарной даты.
- Проверить невозможные и частичные значения.
- Экспортировать и импортировать результат без потери статуса проверки.
При изменении parser не переписывайте уже подтверждённые документы автоматически. Сначала сравните новую интерпретацию с прежней и покажите конфликт. Если исходная строка была прочитана как O3 вместо 03, это отдельная проблема символов; форматирование YYYY-MM-DD её не доказывает и не исправляет.
Для восстановления старых данных потребуется исходник или иной подтверждённый источник. По одной дате 2026-03-04 нельзя узнать, была ли она раньше ошибочно развёрнута из 03/04. Подготовьте искусственные строки, правила шаблонов и diff старого и нового parser. Проверка завершена, когда неоднозначная дата остаётся видимой задачей, а смена языка экрана больше не меняет смысл принятого документа.