This page documents the rules used by the calculators so you can understand exactly how a result is produced.
Calendar-Day Rule
Today is Day 0. One day from today is tomorrow. Standard day calculations count every calendar date, including Saturdays and Sundays.
Weeks
One week is treated as exactly seven calendar days. Adding whole weeks therefore preserves the weekday.
Calendar Months
Months are added as calendar months, not as 30-day estimates. When the starting day does not exist in the target month, the result is clamped to the final valid day of that month. For example, January 31 plus one month becomes February 28 or February 29 in a leap year.
Calendar Years and Leap Day
Years are added as calendar years. February 29 moved to a non-leap year is clamped to February 28.
Business-Day Rule
Business-day calculations advance only on the weekdays selected by the user. The default working week is Monday through Friday. Public holidays are not silently excluded because holiday calendars vary by location and institution.
Time Zone
The interactive calculator uses the visitor’s device date. Server-rendered fallback values use the WordPress site time zone until the browser updates supported dynamic result elements.
How Are Same-Date Ranges Handled?
When the start and end date are the same, the elapsed difference is 0 days if the start date is excluded. If both endpoints are explicitly counted, the result is 1 calendar date. Working-day and weekend totals follow the same endpoint rule.
How Are Past-Date Spans Counted?
For a backward calculation, the starting date is excluded and the resulting past date is included. This mirrors the forward rule, where the starting date is excluded and the resulting future date is included.
How Can a Result Be Independently Checked?
Whole-week intervals should preserve the weekday, fixed day counts should match spreadsheet date addition or subtraction, and calendar-month results should respect the target month’s final valid day. These checks help catch implementation errors without changing the published counting convention.
Why Is Today Treated as Day 0?
Date-offset questions usually ask how far to move from a starting date. Treating the start as Day 0 makes one day from today equal tomorrow and one day ago equal yesterday. This convention is also consistent with ordinary spreadsheet date addition and subtraction.
How Are Weekends Counted?
Standard day calculations include Saturday and Sunday because they are calendar dates. The working-day tools count only the weekdays selected by the user. Keeping these two modes separate prevents a calendar-day result from silently changing meaning.
Why Are Public Holidays Not Removed Automatically?
There is no single global holiday calendar. National, regional, bank, court, employer and school closures can differ, and official dates can change. The theme therefore does not silently subtract holidays from a generic business-day result.
How Does the Current Date Stay Accurate?
The interactive browser result uses the visitor’s local calendar date. Server-rendered fallback content uses the WordPress site time zone and is given a short cache lifetime so date-sensitive HTML is not intended to persist across a new local day.
Validation Approach
Browser and server calculations are designed to use the same rules for days, weeks, months and years. Theme releases are syntax-checked and the packaged ZIP is validated before delivery. Important external deadlines should still be verified against the rule or authority that controls them.