formkit/tempo
Tempo
Tempo is a JavaScript date manipulation library that provides a suite of tools for parsing, formatting, and calculating dates and times. It serves as a date arithmetic engine, a locale-aware formatter, and a timezone offset manager for native JavaScript date objects.
The library includes a dedicated ISO 8601 date parser for validating and converting standardized strings into date objects. It handles geographic normalization through IANA timezone offset management and utilizes the native Internationalization API for region-specific date formatting.
The project covers a broad range of date and time capabilities, including date difference calculations, the manipulation of specific time units, and the normalization of time boundaries. It also provides utilities for comparing dates, setting specific date components, and generating localized date ranges.
Features
- Date and Time Libraries - Provides a comprehensive set of utilities for parsing, validating, manipulating, and formatting date and time values.
- Date Manipulation Utilities - Provides tools to add, subtract, or set specific time units like years and hours with configurable overflow.
- Immutable Date Libraries - Ensures predictable state changes by returning new date objects after every operation to prevent side effects.
- Date Arithmetic Logic - Provides a set of functions for calculating differences and adjusting time values with configurable overflow behavior.
- Date String Parsers - Creates date objects from ISO 8601 strings while applying specific IANA timezone offsets.
- Date Validation Utilities - Converts date strings and ISO 8601 formats into date objects while verifying their structural correctness.
- Date Formatting Utilities - Converts date objects into human-readable strings using localized styles or custom formatting tokens.
- Date String Formatters - Transforms date objects into strings using locale-aware patterns and timezone offsets.
- Localized Formatters - Transforms dates into human-readable strings based on specific language and regional settings using the Intl API.
- Date Difference Calculators - Finds the duration between two dates as a structured object or a specific unit of time.
- ISO 8601 Standards - Provides a compatibility layer to validate and transform date strings according to the ISO 8601 international standard.
- ISO 8601 Parsers - Provides a dedicated utility for validating and converting ISO 8601 strings into date objects with timezone handling.
- Timezone Management - Implements logic to map IANA timezone identifiers to numeric offsets for geographic date normalization.
- Internationalization API Integrations - Utilizes the browser native Internationalization API for region-specific date formatting and locale-aware name generation.
- Internationalized Date Formatting - Transforms date objects into human-readable strings using locale-aware patterns and language settings.
- Date Component Extractors - Retrieves granular parts of a date value, such as the day of the year or locale-specific month names.
- Component Mutators - Allows updating specific parts of a date, such as the hour, minute, or day, to a precise value.
- Temporal Boundary Normalization - Provides capabilities to set a date to the start or end of a specific period like a day, month, or year.
- Token-Based Parsers - Matches custom date format strings against regex patterns to extract and transform date components.
- Date Comparison Utilities - Checks if one date is before, after, or equal to another, or if they share specific time components.
- Temporal Boundary Normalization - Provides utilities to snap date objects to the start or end of days, hours, minutes, months, weeks, or years.
- Date Utilities - Tree-shakable library for native Date objects.
