time-rs/time
Time
This project is a comprehensive library for handling dates, times, durations, and UTC offsets within the Rust programming language. It provides a framework for temporal data processing, utilizing specialized structures to maintain nanosecond precision for high-accuracy scheduling and logging requirements.
The library distinguishes itself through extensive use of compile-time evaluation, which allows for the generation and validation of temporal values during the build process to eliminate runtime overhead. It employs strongly-typed primitives and overflow-checked arithmetic to ensure that all mathematical operations and data manipulations remain safe and valid. Furthermore, the framework includes cross-platform utilities for resolving local system offsets and managing time zone data across diverse operating environments.
Beyond its core processing capabilities, the library supports a broad range of temporal operations, including parsing and formatting strings according to international standards like ISO 8601 and RFC 3339. It also provides extended date range support for historical or long-term planning and integrates with the broader ecosystem through standardized traits for serialization, testing, and random number generation.
Features
- Time and Date Handling - Manages calendar dates, clock times, and durations in Rust applications with high precision and safety checks.
- Date and Time Libraries - Provides a comprehensive library for handling dates, times, durations, and UTC offsets with nanosecond precision.
- Numeric and Date Formatting - Converts temporal data types to and from strings using customizable patterns supporting international standards like ISO 8601.
- High-Precision Temporal Types - Stores dates, clock times, and time spans using specialized types that maintain nanosecond precision.
- Temporal Data Processing - Implements specialized structures for performing arithmetic, formatting, and parsing of temporal data according to international standards.
- Compile-Time Expression Evaluation - Computes and validates temporal values during the build process to eliminate runtime overhead.
- Strongly-Typed Data Mappings - Organizes time data into distinct, type-safe primitives that prevent invalid operations and ensure nanosecond precision.
- Temporal Arithmetic - Executes arithmetic operations on dates and timestamps with safety checks to prevent overflow or invalid results.
- Compile-Time Evaluators - Utilizes constant expressions to generate and validate temporal values during the build process, minimizing runtime overhead.
- Temporal Component Extraction - Provides structures to inspect and update specific calendar components within complex date and time structures.
- Temporal Serialization - Serializes temporal data into standard formats like Unix timestamps or custom strings to ensure consistency across systems.
- Time Zone Management - Handles UTC offsets and local time zone data by updating values from system environment variables.
- System Time Zone Identification - Queries host operating systems to determine accurate local UTC offsets for global applications.
- System Offset Resolvers - Provides cross-platform utilities to resolve local system UTC offsets and manage time zone data dynamically.
- UTC Offset Calculations - Queries the host system to dynamically determine local time zone adjustments and UTC offsets.
- Procedural Macro Engines - Automates the creation of complex temporal constants and validation logic at compile time using procedural macros.
- Integer Overflow Detections - Performs arithmetic operations on temporal data with built-in safety checks to prevent integer overflow errors.
- Compile-Time Validators - Validates date and time values during compilation to catch errors early and ensure format compliance.
- Extended Date Ranges - Supports calendar dates beyond the standard four-digit year limit for historical or long-term planning.
