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

Библиотека Validator.js предоставляет набор утилит для проверки строковых значений, включая специализированные методы для работы с датами. Сравнение дат в рамках этой библиотеки основано на строгой интерпретации строковых представлений времени и опирается на правила нормализации форматов, прежде чем выполняется логическое сравнение.

Корректное сравнение дат невозможно без унификации входных значений. Validator.js ориентируется на стандартизированные форматы, прежде всего ISO 8601. Строки вида YYYY-MM-DD, YYYY-MM-DDTHH:mm:ssZ и их расширенные варианты рассматриваются как предпочтительные.

Основные особенности обработки:

  • строки предварительно приводятся к объектам даты JavaScript;
  • некорректные форматы отклоняются без попытки интерпретации «по смыслу»;
  • локальные форматы (например, DD.MM.YYYY) не считаются надёжными без дополнительной обработки;
  • временные зоны учитываются только при явном указании.

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

Проверка корректности даты перед сравнением

Перед выполнением операций сравнения Validator.js использует проверку валидности входного значения. Это критический этап, так как сравнение некорректных дат приводит к непредсказуемым результатам.

Используется базовая логика:

  • строка должна соответствовать поддерживаемому формату;
  • значение должно корректно преобразовываться в Date;
  • результат преобразования не должен быть NaN.

Пример:

validator.isDate('2026-05-11'); // true
validator.isDate('11-05-2026'); // false (не ISO)
validator.isDate('invalid-date'); // false

Сравнение дат: базовые принципы

Основные функции сравнения в Validator.js:

  • isBefore
  • isAfter
  • isSame (в зависимости от версии и расширений)

Механизм работы основан на преобразовании строк в числовое представление времени (timestamp), после чего выполняется простое арифметическое сравнение.

Логика сравнения

  1. обе строки преобразуются в даты;
  2. даты приводятся к числу миллисекунд с начала Unix-эпохи;
  3. выполняется сравнение числовых значений.

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

Функция isBefore

Функция определяет, предшествует ли первая дата второй.

validator.isBefore('2024-01-01', '2025-01-01'); // true
validator.isBefore('2025-01-01', '2024-01-01'); // false

Особенности поведения:

  • при равных датах результат всегда false;
  • учитываются часы, минуты и секунды при их наличии;
  • при отсутствии времени используется начало суток.

Функция isAfter

Логически противоположна isBefore и проверяет, следует ли первая дата после второй.

validator.isAfter('2026-01-01', '2025-01-01'); // true
validator.isAfter('2025-01-01', '2025-01-01'); // false

Важный аспект заключается в том, что сравнение строгое: равные значения не считаются «после».

Учет времени и временных зон

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

Пример:

validator.isBefore('2026-01-01T10:00:00Z', '2026-01-01T12:00:00Z'); // true
validator.isAfter('2026-01-01T10:00:00+03:00', '2026-01-01T08:00:00Z'); // зависит от нормализации

Ключевые моменты:

  • Z обозначает UTC;
  • смещения +03:00, -05:00 приводятся к UTC перед сравнением;
  • при отсутствии указания зоны используется локальное время среды выполнения.

Пограничные случаи

Сравнение дат часто сталкивается с неоднозначными ситуациями.

1. Равенство дат

Validator.js не всегда предоставляет отдельную функцию строгого равенства дат. Поэтому равенство обычно определяется комбинацией:

!isBefore(a, b) && !isAfter(a, b)

2. Некорректные строки

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

validator.isBefore('invalid', '2025-01-01'); // false

3. Частично заданные даты

Строки без времени интерпретируются как 00:00:00:

validator.isAfter('2025-01-01', '2025-01-01T12:00:00Z'); // false

Сравнение дат с ограничениями диапазона

Validator.js позволяет задавать дополнительные параметры в некоторых реализациях, ограничивающие допустимый диапазон сравнения.

Типичный сценарий:

  • проверка, находится ли дата до определённого предела;
  • проверка, не выходит ли дата за допустимый интервал.

Пример логики:

validator.isBefore('2024-12-31', '2025-01-01'); // контроль верхней границы
validator.isAfter('2024-01-01', '2023-12-31');  // контроль нижней границы

Сравнение строк vs сравнение дат

Ошибкой считается попытка сравнивать даты как строки:

'2026-1-2' > '2026-01-10' // некорректно

Lexicographical сравнение не отражает реальную хронологию. Validator.js решает эту проблему через нормализацию в timestamp.

Производственные сценарии применения

Сравнение дат используется в следующих типовых задачах:

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

Каждый из сценариев опирается на единый принцип: преобразование строки в унифицированное числовое значение времени.

Взаимодействие с нативным JavaScript Date

Внутренняя модель сравнения тесно связана с объектом Date.

new Date('2026-01-01').getTime()

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

Ограничения подхода

Несмотря на универсальность, методология сравнения имеет ограничения:

  • зависимость от корректности входного формата;
  • неоднозначность при локальных форматах дат;
  • различия в интерпретации строк между окружениями Node.js и браузером;
  • невозможность учитывать бизнес-логику временных зон без дополнительной обработки.

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

Обобщённая модель сравнения

Процесс сравнения дат в Validator.js можно представить как последовательность:

  • получение входных строк;
  • проверка формата;
  • преобразование в Date;
  • конвертация в timestamp;
  • числовое сравнение;
  • возврат булевого результата.

Такая модель обеспечивает предсказуемость и минимизирует неоднозначность при обработке временных данных.

Оглавление