Разница календарных дат и количество включенных в период дней — не одно и то же. Между соседними датами проходит один день, но период, включающий обе даты, содержит два календарных дня.
Для общего количества дней даты упорядочиваются и нормализуются к календарному дню. При включении последнего дня к разнице добавляется 1. Число полных недель = floor(дни / 7); остаток = дни mod 7. Разбивка на годы и месяцы рассчитывается отдельно календарными переходами.
Между 1 октября 2026 года и 10 октября 2026 года — 9 дней, или 1 неделя и 2 дня. При включении последнего дня получается 10 дней, или 1 неделя и 3 дня.
Выходные и праздники не исключаются: это не производственный календарь. При обратном порядке дат используется положительная длина периода. Календарная разбивка на месяцы зависит от их длины и переходов Date, особенно у конца месяца; для сравнения периодов надежнее ориентироваться на общее число дней. Исторические часовые пояса и время суток не моделируются.