sdispater/pendulum
Pendulum
Pendulum is a Python date and time library that provides a simplified interface for date arithmetic, ISO parsing, localization, and timezone management. It serves as a replacement for the standard library datetime module, extending existing classes to maintain compatibility while offering a more intuitive management interface.
The library distinguishes itself through a natural language date formatter that translates time differences into localized strings and a dedicated ISO 8601 date parser. It also includes tools for time-dependent logic testing, allowing the system clock to be mocked or fixed to a specific point in time for consistent software verification.
Broad capabilities include complex date arithmetic, boundary shifting, and timezone conversion with automatic daylight saving time transition handling. It further supports date string parsing, period iteration for generating sequences of dates, and the transformation of date objects into human-readable formats using a token-based system.
Features
- DateTime Libraries - Provides a comprehensive library for creating, manipulating, and formatting date and time objects in Python.
- Date Component Modifiers - Modifies specific attributes of a date instance, such as the year or hour, to return a new instance.
- Daylight Savings Normalizations - Automatically handles daylight saving time transitions and resolves ambiguous local times.
- Date Object Creators - Generates date and time objects from Unix timestamps, standard library instances, or relative helpers.
- Date Sequence Generators - Provides utilities for calculating and yielding consecutive series of dates based on specific intervals.
- Date Arithmetic Logic - Provides intuitive arithmetic methods to add or subtract units like days, weeks, or minutes.
- Duration Calculations - Determines the length of time between two points, supporting complex units like years and months.
- Date String Parsers - Offers utilities for automatically converting common date strings into native date objects.
- Date Validation Utilities - Converts ISO or RFC formatted strings into date objects using strict and flexible parsing rules.
- Date Comparison Utilities - Allows determining if a date occurs before, after, or at the same time as another using standard operators.
- Date Formatting Utilities - Provides utilities to transform date objects into strings using custom tokens and ISO formats.
- Human-Readable Formatters - Converts date objects into user-friendly, natural language strings and localized descriptions.
- Date Localizations - Translates date and time descriptions into various languages using global or call-specific locale settings.
- Natural Language Formatters - Translates time differences and dates into localized, human-readable natural language strings.
- Date Difference Calculators - Computes the duration between two date objects and expresses the result in specific units.
- Standard Library Extensions - Extends Python's native datetime and timedelta classes to maintain compatibility while simplifying manipulation.
- Date Range Iterators - Implements utilities for generating sequences of date objects between two points in time.
- ISO 8601 Parsers - Includes a dedicated parser for transforming ISO 8601 formatted strings into datetime objects.
- Timezone Management - Implements logic for converting date objects between different timezones while maintaining the same moment.
- Time Freezing Utilities - Allows setting a constant date and time for all current time requests to ensure consistent test results.
- Month Boundary Calculations - Adjusts date instances to the start or end of specific periods like months or centuries.
- Token-Based Formatters - Processes custom date tokens through a translation layer to generate human-readable strings.
- Relative Time Humanization - Creates human-friendly, localized strings describing the relative distance between two dates.
- Temporal String Interpolation - Maps time units to localized word sets to convert durations into natural human languages.
- System Clock Mocks - Intercepts system clock calls to simulate specific dates and times for consistent software testing.
- Time Simulation Utilities - Intercepts and controls native timing functions to simulate specific points in time for logic testing.
- Data Manipulation Libraries - Datetime library with timezone support.
- Date and Time - Predictable and intuitive date and time manipulation.
