python-pendulum/pendulum

Features

• Date and Time Libraries - Implements a comprehensive suite for creating, manipulating, and formatting date and time objects with timezone awareness.
• Daylight Savings Normalizations - Automatically handles daylight savings transitions and normalizes dates across DST boundaries.
• String-to-Datetime Parsing - Features a dedicated parser that converts ISO 8601 and RFC 3339 strings into timezone-aware objects.
• Date Arithmetic Logic - Provides computational tools for adding or subtracting specific durations of time from date instances.
• Arithmetic Engines - Ships a specialized engine for date arithmetic, including adding durations and iterating through ranges.
• Date String Parsers - Provides specialized utilities for automatically converting ISO 8601 and RFC 3339 strings into native date objects.
• Temporal Arithmetic - Performs precise additions and subtractions of time units and calculates complex intervals between dates.
• Date Formatting Utilities - Converts date objects into human-readable strings using standard ISO formats or custom token systems.
• DateTime Libraries - Provides a comprehensive Python library for timezone-aware date and time manipulation.
• Date Difference Calculators - Computes the duration between two date instances and expresses the result in units like hours or days.
• Relative Time Humanization - Produces natural language descriptions of time differences, such as '2 hours ago' or '1 month from now'.
• Temporal Interval Measurements - The library measures the distance between two points in time using complex units like years and months.
• ISO 8601 Parsers - Includes specialized parsers for converting ISO 8601 and RFC 3339 standardized strings into programmable objects.
• Timezone Management - Provides advanced logic for managing geographic timezones and handling wall-clock shifts across different regions.
• Temporal - Produces a series of timestamps by iteratively adding fixed durations between two boundary points.
• Chronological Comparisons - Determines if one date occurs before, after, or at the same time as another using comparison operators.
• Date Component Extractors - Retrieves specific time components such as day of year or UTC offset as integers or floats.
• Date Component Modifiers - Creates new date instances by updating specific components like year or month without mutating the original object.
• Standard Format Recognizers - Outputs dates in predefined industry formats including Atom, Cookie, RSS, and various RFC specifications.
• Date Sequence Generators - Generates programmatic sequences of dates between two points using fixed intervals for time-series analysis.
• Temporal Boundary Normalization - Snaps a date to the start or end of a specific calendar period, such as the beginning of a week or month.
• Date String Formatters - Renders dates into human-readable strings using specific language locales for names and phrases.
• Date Difference Phrases - Produces natural language descriptions of time differences, such as '2 hours ago', with locale support.
• Immutable Data Patterns - Implements an immutable object pattern for date instances to prevent unintended side effects during arithmetic.
• Date-Time Format Strings - Uses a mapping of custom tokens and locale-specific strings to translate date attributes into human-readable text.
• System Clock Mocks - Intercepts system clock calls to return predefined timestamps for consistent results during automated testing.
• Virtual Time Testing - Provides utilities to decouple the application from the system clock for deterministic time-sensitive testing.
• Relative Time Formatting - The library converts time differences into human-readable strings or localized words for improved user presentation.
• System Clock Mocking - The library manipulates the perceived current time by shifting to absolute or relative points in the future or past.
• Date And Time - Simplifies datetime handling with a user-friendly API.

Star history