HowardHinnant/date
Date
This project is a comprehensive date and time library designed for parsing, formatting, and calculating dates and times with high precision. It provides a multi-calendar system implementation that supports conversions between proleptic Gregorian, Julian, ISO week, and Tabular Islamic calendars.
The library is distinguished by its high-precision time clocks and its implementation of the IANA time zone database. It tracks physical time using UTC, TAI, and GPS clocks to account for leap seconds and provides a system for managing geographic time zones and offsets based on IANA data.
The capability surface includes a date and time parser for extracting time points from text streams using locale-aware patterns. It also covers temporal arithmetic for calculating durations between time points and tools for converting time across different geographic zones.
Features
- Date and Time Libraries - Provides a comprehensive suite of utilities for constructing and manipulating date and time values.
- High-Precision Physical Time Tracking - Measures physical time using UTC, TAI, and GPS clocks while accounting for leap seconds and clock drift.
- Time Zone Management - Converts time points between different geographic zones using the IANA Time Zone Database and custom offset rules.
- Date and Time Utilities - Provides a comprehensive set of tools for parsing, formatting, and calculating dates and times with high precision.
- Date String Parsers - Extracts structured time and date information from text streams using custom format patterns and locale-aware flags.
- Clock Domain Conversion - Converts time points between different clock domains, such as translating system time into UTC or TAI.
- Physical Time Tracking - Maintains continuous physical seconds using UTC, TAI, and GPS clocks.
- Clock Domain Casting - Implements a unified mechanism for transforming time values between different clock systems while preserving the absolute moment.
- IANA Time Zone Database Integrations - Uses a structured representation of the IANA time zone database to handle regional offsets and historical transitions.
- Leap Second Management - Performs high-precision time calculations that account for leap seconds.
- Multi-Calendar System Implementations - Supports conversions between proleptic Gregorian, Julian, ISO week, and Tabular Islamic calendars.
- Multi-Calendar Systems - Supports conversions and calculations across Gregorian, Julian, ISO week, and Tabular Islamic calendars.
- Temporal Arithmetic - Calculates the precise duration between two time points in terms of years, months, weeks, or days.
- Physical Clock Implementations - Tracks physical time using UTC, TAI, and GPS clocks to account for leap seconds.
- Type-Safe Clock Domains - Provides distinct types for system, UTC, and TAI time to prevent logic errors during clock conversion.
- Calendar System Interoperability - Translates dates between Gregorian, Julian, ISO week, and Tabular Islamic calendar systems.
- Civil Date Management - Provides a system for creating and manipulating dates using a proleptic Gregorian calendar.
- Custom Time Zone Rules - Allows the creation of user-defined time zone rules and offsets for zoned time calculations.
- Historical Calendar Calculations - Calculates dates and converts between civil, Julian, and ISO-week systems using a proleptic Julian calendar.
- Proleptic Calendar Logic - Calculates historical dates by extending the Gregorian and Julian calendars backward in time.
- Temporal Decompositions - Decomposes durations since midnight into structured hours, minutes, seconds, and fractional seconds.
- Date Difference Calculators - Computes the precise duration between two time points in terms of years, months, weeks, or days.
- Time Zone Converters - Converts local calendar date and time to UTC time points based on specific geographic zone rules.
- Calendar Arithmetic - Provides logic to add or subtract years and weeks from ISO week dates.
- Calendar Conversions - Transforms civil or ISO-week dates into the proleptic Tabular Islamic calendar system.
- Calendar Logic Utilities - Determines the day of the week for a given system time point using ISO 8601 encoding.
- Tabular Islamic Calendar Conversions - Implements the proleptic tabular Islamic calendar through mathematical transformations from civil and ISO-week dates.
- Time Point Conversions - Transforms between system time points, local time points, and field-based representations.
- ISO 8601 Standards - Implements ISO 8601 standards to map calendar dates to specific years, week numbers, and weekdays.
- Locale-Aware Value Formatting - Translates time points into strings using customizable format flags and system-specific locale settings.
- Calendar Field Decomposition - Provides a mechanism to decompose continuous time points into discrete year, month, and day fields for calendar operations.
- Date and Time Formatting - Converts date and time objects into human-readable strings using locale-aware flags and custom patterns.
- General Utilities - Date and time library based on C++11/14/17 standards.
