dromara/carbon
Carbon
Carbon is a Go library for semantic date and time calculations, formatting, and parsing. It provides a semantic interface to simplify temporal data handling and improve the readability of date and time manipulations.
The library is distinguished by its support for multi-calendar date conversion, allowing transformations between Gregorian, Chinese Lunar, Persian, and Hebrew calendar systems. It also includes a localized temporal framework that uses ISO 639-1 codes to format dates and relative time differences across multiple language locales.
Additional capabilities cover global time zone management, the parsing of date strings via fuzzy templates and standard formats, and the calculation of relative time and meteorological seasons. For quality assurance, the project includes tools for deterministic time mocking to freeze the system clock during unit tests.
Features
- Date and Time Libraries - Provides a semantic interface for parsing, validating, and manipulating date and time values.
- Temporal Type Wrappers - Wraps standard library time types in a custom structure to provide a more expressive and readable API.
- Date and Time - Provides a semantic interface for performing complex date and time calculations without external dependencies.
- Localized Formatting - Formats date and time output using ISO 639-1 language codes to support global languages.
- Date Object Creators - Generates time objects from individual components like year, month, and day or from Unix timestamps.
- Time Zone Management - Handles time zone settings and performs conversions between different regional time offsets.
- Cross-Calendar Conversions - Transforms dates between Gregorian, Chinese Lunar, Persian, and Hebrew calendar systems.
- Inter-Calendar Transformations - Transforms dates between various systems including Julian, Chinese Lunar, Persian, and Hebrew calendars.
- Multi-Calendar Conversions - Enables transformations between Gregorian, Chinese Lunar, Persian, and Hebrew calendar systems.
- Temporal Component Extractors - Retrieves specific units of time such as years, months, days, or timestamps from a given date.
- Custom Date-Time Format Patterns - Converts time objects into strings using semantic tokens for custom formatting of dates and time zones.
- Token-Based Templates - Uses alphanumeric tokens in format strings to map date components into custom output representations.
- Date String Parsers - Converts date and time strings into usable objects using standard patterns and custom layouts.
- Template-Based Date Parsing - Matches input strings against predefined or fuzzy patterns to resolve them into usable date objects.
- Locale Mappings - Uses lookup tables and ISO 639-1 codes to map temporal labels into different human languages.
- Relative Date Generators - Generates date objects for days preceding or following the current date using semantic shortcuts.
- Date Localizations - Supports the translation of date and time descriptions into multiple languages using ISO 639-1 locale settings.
- Date Difference Calculators - Computes the duration between two time points and expresses results in human-readable or numeric units.
- Relative Time Humanization - Expresses the difference between two dates as human-readable relative time strings across multiple locales.
- Time Zone Converters - Provides functions to set, retrieve, and convert time instances between different geographical time zones.
- Multi-Calendar Converters - Implements mathematical algorithms to convert Gregorian dates into lunar, Persian, or Hebrew calendar systems.
- Localized Calendar Labels - Translates calendar-related labels such as months, weeks, and seasons into multiple supported languages.
- Date and Time Formatting - Converts time strings into objects and outputs them in ISO and RFC standards.
- Internationalized Date Formatting - Provides locale-aware formatting to convert date and time objects into human-readable strings.
- Time Freezing Utilities - Locks the system clock to a constant value to ensure deterministic results in unit tests.
- Global Defaults - Enables setting global defaults for timezones, language locales, and weekend definitions.
- String Localization - Provides mechanisms for retrieving and formatting localized time and date components.
- Standard Time Formatters - Converts time objects into standards like ISO8601 and RFC series for display and transmission.
- Deterministic Testing Clocks - Decouples time measurement from the system clock to enable reproducible Go unit tests.
- Temporal Translation Mappings - Uses internal translation mappings to localize date and time strings into various languages.
- System Clock Mocks - Allows freezing the system clock with a fixed timestamp to ensure deterministic behavior during unit tests.
- Time Simulation Utilities - Intercepts native timing functions to simulate a fixed clock for subsequent date operations.
- Global Configuration - Provides a centralized configuration system to synchronize default timezones and locales across the application.
- Date And Time - Semantic and developer-friendly time package.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
