Why This Page Exists
This guide explains exactly how DateCalcPro calculates results. We publish formulas and edge-case behavior so users can understand results, audit important calculations, and verify high-stakes deadlines with confidence.
Last reviewed: March 26, 2026.
Core Principles
- Local date parsing: Inputs in
YYYY-MM-DDformat are parsed as local calendar dates to avoid UTC conversion shifts. - DST-safe day counts: Day differences use UTC day numbers, not raw timestamp division, to avoid daylight-saving off-by-one errors.
- Month-end clamping: Adding months/years clamps to the last valid day of the target month.
- ISO standard compliance: Week numbers follow ISO 8601 rules (Monday-first, Week 1 contains the first Thursday).
Days Between Formula
For two dates A and B, we compute:
Total Days (inclusive) = UTC_DAY(B) - UTC_DAY(A) + 1
This avoids local timezone drift and keeps results consistent across regions.
Add/Subtract Month-End Rule
When adding/subtracting months or years, we do not allow overflow into the next month. Instead, we clamp to the last valid day in the target month.
- January 31 + 1 month = February 28 (or 29 in leap years)
- March 31 - 1 month = February 28 (or 29 in leap years)
- February 29 + 1 year = February 28 in non-leap years
ISO Week Number Method
Week numbers are computed in UTC to avoid DST boundary drift:
- Convert input date to UTC calendar date.
- Shift to nearest Thursday (ISO anchor day).
- Compute week-year from that Thursday.
- Calculate week index from January 1 of week-year.
Validation Checklist
Before production updates, we check:
- Leap-year transitions (e.g., Feb 28/29 behavior)
- Month-end transitions (31-day and 30-day months)
- DST transition windows in multiple timezones
- ISO week-year boundaries near Jan 1 and Dec 31
High-Stakes Use Reminder
DateCalcPro aims for high mathematical accuracy, but legal, financial, payroll, tax, and regulatory deadlines may depend on jurisdiction-specific rules and contractual definitions. Always verify final deadlines against official documentation and qualified professional advice.