Date & Time Guide

UTC, GMT, and Time Zones

Coordinated Universal Time (UTC) is the primary time standard by which the world regulates clocks and time. It is not technically a time zone but a standard. Greenwich Mean Time (GMT) is often confused with UTC; however, GMT is a time zone, whereas UTC is a time standard. UTC is not adjusted for DST.

Time zones are geographic regions that observe a uniform standard time for legal, commercial, and social purposes. They are generally defined by an offset from UTC (e.g., UTC+5:30).

Epoch Time

Epoch time, or Unix time, is the number of seconds that have elapsed since 00:00:00 UTC on January 1, 1970 (the Unix Epoch). It is the standard way for computer systems to track time internally, as it is a simple, monotonically increasing number that avoids the complexities of calendars and time zones until the moment of presentation to a human.

Calendar Systems

• Gregorian Calendar: The internationally accepted civil calendar. It adjusts for the solar year using leap years every four years, except for years divisible by 100 that are not also divisible by 400.
• Julian Calendar: The predecessor to the Gregorian calendar, which had a slightly different leap year rule, causing it to drift from the solar year over centuries.

Worked Example: Business Day Calculation

To find a deadline 10 business days from a start date, excluding weekends:

1. Start Date: Monday, June 1, 2026.
2. Days to add: 10 business days.
3. Skip weekends: June 6-7, June 13-14.
4. Result: Friday, June 12, 2026.

The Day Counter Calculator automates this, allowing you to exclude specific weekends or holidays.

Worked Example: Payroll

• Shift: 08:00 AM - 05:00 PM (9 hours).
• Break: 1 hour.
• Total payable: 8 hours.

The DST Edge Case

DST causes clocks to spring forward (lose an hour) or fall back (gain an hour).

• Spring: 01:59 AM -> 03:00 AM (the 2:00 AM hour never happens).
• Fall: 01:59 AM -> 01:00 AM (the 1:00 AM hour repeats).

Ambiguous times during the fall back transition must be handled by specifying whether the time is before or after the transition.

Best Practices for Conversions

1. Always store in UTC: Keep all internal timestamps in UTC.
2. Convert at the edge: Only convert to local time when displaying to the user.
3. Use IANA Time Zone Database: Use standard identifiers like America/New_York instead of generic names like EST, which are ambiguous. [iana-tz]

The Time Zone Converter handles these complexities automatically using the IANA database.

Why Leap Years Matter

A standard year is 365 days. Without adjustments, the calendar would drift against the seasons by 0.2422 days per year, amounting to roughly one full day every four years. Adding one day every four years corrects this, but it over-corrects (365.25 > 365.2422). The rule of skipping century years (divisible by 100) unless they are divisible by 400 refines the approximation to 365.2425 days.

Historical Timekeeping and Drift

Historically, civilizations used lunar calendars, solar calendars, and lunisolar calendars. The drift in the Julian calendar (which only had the 4-year leap rule) meant that by the late 16th century, the equinoxes had shifted by about 10 days. Pope Gregory XIII reformed the calendar in 1582 to rectify this, skipping 10 days and introducing the centurial leap year rule. This is why historical date arithmetic before 1582—and in countries that adopted the Gregorian calendar much later—requires sophisticated handling to avoid astronomical inaccuracies.

Time Dilation and Atomic Time

While rarely a concern for civil applications, high-precision timekeeping (like GPS satellites) must account for relativity. Additionally, UTC is maintained by atomic clocks, but it is not perfectly constant. [nist-time] Occasionally, "leap seconds" are added to UTC to keep it aligned with the Earth's rotation, which slows down slightly due to tidal friction and other geophysical factors. This is a significant source of edge-case bugs in high-precision software systems.

Instant vs. Civil Time

• An Instant is a point in time (e.g., UTC timestamp, Unix epoch).
• Civil Time is a representation of that instant in a specific location (e.g., "2026-06-05 14:00:00 in London").

A common mistake is storing a civil time as a UTC timestamp without preserving the original time zone. If a user schedules an event for 2:00 PM in New York, that translates to 6:00 PM or 7:00 PM UTC depending on DST. If you only store the 7:00 PM UTC, you cannot reconstruct the original 2:00 PM local time if the user moves or if the server context changes. Always store the instant AND the time zone/offset pair.

Dealing with Ambiguous Times

When a clock repeats an hour (fall DST), a civil time like "01:30 AM" is ambiguous. It could be the first occurrence or the second. Application UIs should always clarify this, or data storage must use the UTC offset or a "fold" flag (a boolean indicating if the local time represents the first or second occurrence).

Calendar arithmetic in practice

• Durations (Absolute): Elapsed time. Does not change with time zones or DST. 1 hour is always 3600 seconds.
• Periods (Civil): Calendar intervals. Changes based on context. 1 day can be 23, 24, or 25 hours. 1 month can be 28 to 31 days. Always use calendar-aware libraries for periods.

Why you should never use Date in JavaScript

The legacy JavaScript Date object was inspired by Java's deprecated java.util.Date. It suffers from:

• Mutable instances: Changing a date object changes its state, leading to unpredictable side effects in complex arithmetic.
• Zero-indexed months: Months are 0-11, where January is 0, a constant source of off-by-one errors.
• Implicit UTC/Local conversion: It frequently converts back and forth between local time and UTC without explicit instruction, making it difficult to debug.
• Lack of Time Zone support: It has very poor native support for time zones other than local or UTC.

Use modern alternatives like Temporal or date-fns to avoid these traps entirely.

1. Financial Systems and Interest Calculations

Banks calculate interest on a "daily" basis, but they must decide what defines a day. Is it based on a 360-day year (banker's year), a 365-day year, or a 365.25-day year? Each method yields different financial results. Financial applications must strictly define their "day count convention" to avoid regulatory issues.

2. Logistics and Supply Chain

When scheduling global shipping, you are dealing with deadlines that exist in both the supplier's local time and the customer's local time. If a product must be shipped by 5:00 PM local time in Shanghai, the logistics software must convert this to a UTC instant, and then convert that to the carrier's local time in Tokyo to manage the loading schedule. A failure in UTC conversion can lead to missed flights and port congestion.

3. Healthcare Scheduling

For hospitals, appointments in different time zones (e.g., a telehealth appointment) or scheduled surgical interventions require extreme precision. A failure to account for DST can lead to two appointments being booked for the same slot during a "fall back" shift, or patients missing appointments entirely if their local reminders were not calculated correctly according to the hospital's server time.

The Storage Pattern: (Instant, TimeZone, Format)

Instead of a simple string or integer, use a composite data structure:

• timestamp_utc: (ISO 8601 or integer epoch) for sorting, range queries, and calculations.
• timezone_id: (IANA string, e.g., "Asia/Tokyo") to store the context in which the event was scheduled.
• original_civil_time: (String representation) to preserve what the user originally saw, allowing for auditability.

Calendrical Projections

For scheduling long-term events (e.g., recurring meetings over 5 years), never just add (N * weeks) to a timestamp. Because DST transitions move, a meeting scheduled at "10:00 AM" might shift to "09:00 AM" if the stored offset assumes DST and the meeting date does not, or vice versa. Always re-calculate civil times in the destination time zone for each recurring instance based on the calendar rules active on that specific date.

Internationalization and Localization (i18n/l10n)

Displaying dates is just as complex as calculating them.

• Format: 2026/06/05 (ISO) vs 05/06/2026 (UK) vs 06/05/2026 (US).
• Calendar: While Gregorian is standard, some cultures use regional calendars for civil purposes (e.g., Islamic or Buddhist calendars). Your display layer should use Intl.DateTimeFormat in JavaScript, which provides localized formatting automatically based on user locale.

The "Leap Second" Problem

While systems like NTP (Network Time Protocol) use "smearing" (slowly adjusting the clock slightly over 24 hours to hide the leap second) to prevent catastrophic failures, high-precision scientific applications or distributed databases with strict causal ordering requirements cannot afford this inaccuracy. If building such systems, you must use TAI (International Atomic Time), which does not have leap seconds, and only convert to UTC at the presentation layer.

The Gregorian leap year formula

The Gregorian rule can be expressed as: IsLeapYear = (year % 4 == 0) && (year % 100 != 0 || year % 400 == 0)

This formula ensures that the average length of a Gregorian year is exactly 365 + 1/4 - 1/100 + 1/400 = 365.2425 days. The tropical year, which is the time from one vernal equinox to the next, is approximately 365.24219 days. The Gregorian calendar is accurate to within one day every 3,300 years, an extraordinary feat of medieval mathematics.

Zeller's Congruence

Zeller's congruence is a mathematical formula for calculating the day of the week for any Julian or Gregorian calendar date: h = (q + [13(m+1)/5] + K + [K/4] + [J/4] - 2J) mod 7

Where:

• h is the day of the week (0 = Saturday, 1 = Sunday, ..., 6 = Friday).
• q is the day of the month.
• m is the month (3 = March, 4 = April, ..., 12 = December). January and February are counted as months 13 and 14 of the previous year.
• K is the year of the century (year mod 100).
• J is the zero-based century ([year/100]).

This formula demonstrates that calendrical calculations can be treated as pure modular arithmetic, which is why software calculators are so efficient.

NTP (Network Time Protocol)

NTP is the standard protocol for synchronizing computer clocks over packet-switched, variable-latency data networks. It uses a hierarchy of "stratum" levels (Stratum 0 are high-precision atomic clocks, Stratum 1 are servers directly connected to them, etc.) to ensure that servers across the world remain within milliseconds of UTC. Without NTP, distributed systems—like banking networks, cloud services, and global logistics systems—would immediately fail due to causal drift.

Precision Time Protocol (PTP)

For systems requiring microsecond or even nanosecond precision, PTP (IEEE 1588) is used in place of NTP. It is common in high-frequency trading platforms, industrial automation, and professional audio/video infrastructure where network latency and clock jitter are unacceptable.

ISO 8601 Standard

ISO 8601 is the international standard covering the exchange of date and time-related data. [iso8601] Its format, YYYY-MM-DDThh:mm:ss.sssZ, is the bedrock of JSON APIs and database storage. Its design is strictly hierarchical (Year, Month, Day, Hour, Minute, Second), making it ideal for both human readability and machine sorting.