arrow-py/arrow
Arrow
Arrow is a Python date and time library that provides a simplified interface for creating and manipulating timestamps by wrapping the Python standard library. It serves as a tool for managing date objects, handling timezone offsets, and performing relative date calculations.
The library is distinguished by its ability to humanize timestamps into natural language relative descriptions across multiple locales and parse human-readable time phrases back into precise date objects. It also features a specialized parser for converting ISO 8601 strings and custom formatted text into date objects.
Broad capabilities include temporal arithmetic for shifting dates, range generation for calculating time spans, and boundary rounding to align timestamps to specific units. It also covers global timezone and daylight savings transitions, as well as locale-driven translation for internationalized date formatting.
Features
- Date and Time Libraries - Provides a simplified Python library for parsing, validating, manipulating, and formatting date and time values.
- Standard Library Wrappers - Provides a simplified interface that wraps the Python standard library datetime module to improve ergonomics.
- Relative Date Generations - Enables the creation of date objects using relative offsets like days, weeks, or months.
- Date Object Creators - Instantiates date and time objects from common input standards such as ISO 8601.
- Date String Parsers - Automatically converts ISO 8601 strings or custom text into native date objects.
- Temporal Arithmetic - Provides functions for adding or subtracting time increments from timestamps while accounting for calendar variations.
- Natural Language Formatters - Translates timestamps and time intervals into colloquial, natural language phrases based on locale.
- Relative Time Humanization - Translates timestamps into localized, human-readable relative time descriptions like 'two hours ago'.
- Natural Language Time Parsers - Parses human-readable time phrases and relative strings back into precise date objects using rule-based patterns.
- ISO 8601 Parsers - Implements specialized parsing to convert ISO 8601 compliant date-time strings into Python date objects.
- Temporal Natural Language Parsing - Provides utilities to parse human-readable date and time strings into structured temporal objects.
- Timezone Management - Provides comprehensive logic for managing global timezone offsets and daylight savings transitions.
- Timezone Conversions - Changes the timezone of a timestamp and handles corresponding offset conversions for different geographic regions.
- Chronological Comparisons - Provides logic for determining chronological relationships to check if one timestamp occurs before or after another.
- Relative Offset Management - Shifts dates and times forward or backward using relative offsets for units ranging from microseconds to years.
- Date Manipulation Utilities - Provides tools for performing arithmetic and transformations to adjust timestamps by specified durations.
- Bidirectional Parsing - Transforms date objects into strings and parses strings back into date objects using automated rules.
- Calendar Date Calculations - Calculates date shifts by adding or subtracting calendar units while accounting for varying month and year lengths.
- Temporal Offset Calculations - Performs calculations of time intervals and relative offsets such as hours, days, or weeks.
- Temporal Rounding - Provides utilities to align timestamps to the nearest floor or ceiling boundary based on specific time units.
- Token-Based Templates - Generates formatted strings from date objects using custom token patterns and built-in templates.
- Locale Mappings - Uses lookup tables and mapping logic to translate temporal components into language-specific equivalents for globalized output.
- Timestamp Generators - Generates date and time objects from simplified input options and current system time.
- Date Formatting Utilities - Offers utilities for formatting date and time values into human-readable strings via customizable patterns.
- Date Localizations - Adapts date representations and names to specific global locales and languages.
- Temporal String Interpolation - Transforms date objects into human-readable strings using customized alphanumeric tokens and predefined mappings.
- Temporal Span Calculators - Calculates time spans, ranges, floors, and ceilings for frames ranging from microseconds to years.
- Date Range Iterators - Generates programmatic sequences of date objects between two points in time using a specified interval.
- Temporal Translation Mappings - Uses external mapping files to swap date and time components with language-specific equivalents.
- Interpolation Tokens - Translates custom alphanumeric tokens into date and time components for flexible string generation.
- Internationalized Date Formatting - Adapts date and time strings to specific languages and locales for user-facing displays.
- Data Manipulation Libraries - Enhanced work with dates and times.
- Date And Time - Human-friendly date and time manipulation.
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.
