malcommac/SwiftDate
SwiftDate
SwiftDate is a date manipulation library for the Swift programming language. It provides a toolkit for parsing, validating, and formatting dates, times, and timezones.
The library includes a relative time generator for producing date offsets based on reference points such as tomorrow or next week, and a localized date formatter for transforming date objects into human-readable strings across multiple languages and locales. It also features an ISO8601 date parser to convert standardized date strings from SQL, HTTP, and ISO8601 formats into structured objects, alongside tools for managing timezones across different geographical regions.
Broad capabilities cover date arithmetic and value adjustment, chronological comparison, and regional date conversion. The project also provides utilities for date component extraction, random date generation for testing, and the management of time periods and intervals.
The library supports the serialization and deserialization of date and region information for data storage and network transmission.
Features
- Date Manipulation Utilities - Provides a comprehensive toolkit for date arithmetic, adding or subtracting time units, and calculating durations in Swift.
- Date and Time Libraries - Provides a comprehensive toolkit for adding or subtracting time units like hours, minutes, and days.
- Arithmetic Logic - Provides a structured unit-based system for calculating new dates by applying offsets to specific time components.
- Numeric and Date Formatting - Transforms date and time objects into human-readable strings according to regional localization and layout requirements.
- ISO8601 Serialization - Supports encoding and decoding of date objects using the ISO8601 international standard for consistent data representation.
- Standard Format Recognizers - Automatically recognizes major date formats like ISO8601, SQL, and HTTP to create structured date objects.
- Fluent Date Processing - Implements a fluent API wrapper around native date types to enable more readable and intuitive date manipulation through method chaining.
- Relative Date Formatting - Displays dates as relative time offsets in multiple languages using customizable styles.
- Date String Parsers - Converts text into date objects by matching input strings against predefined or custom format templates.
- Localized Formatters - Transforms date and time objects into human-readable strings across multiple languages and locales.
- Timezone Management - Manages and converts time across different geographical regions and offsets to ensure global accuracy.
- Locale-Aware Value Formatting - Transforms date objects into human-readable strings based on regional locales and calendar settings.
- Internationalized Date Formatting - Converts date objects into human-readable text using colloquial styles and multi-language support.
- Chronological Comparisons - Provides capabilities to determine chronological relationships between dates, including checks for identical days.
- Date Component Extractors - Retrieves specific individual components of a date, such as the weekday or hour, for use in application logic.
- Interval Comparisons - Determines the chronological order between different points in time and adjusted intervals.
- Reference Date Derivations - Provides functionality to create new dates based on a specific reference point using predefined generation functions.
- Regional Conversions - Transforms dates from one calendar, locale, or timezone to another while preserving the expressed value.
- Regional Date Creations - Allows generating date objects from strings or components while specifying target timezones, calendars, and locales.
- Relative Date Generations - Creates new date objects based on temporal offsets such as tomorrow, next week, or the next available weekday.
- Time Period Managements - Implements integrated logic to handle defined spans of time, durations, and intervals.
- Relative Date Generators - Produces dates and time offsets based on natural language reference points like tomorrow or next week.
- Duration Interval Calculators - Provides utilities for computing the precise differences and spans of time between two date points.
- Relative Date Generators - Produces date offsets and new date objects based on reference points such as tomorrow or next week.
- Date Validation - Provides validation checks to verify that date strings match expected formats and are chronologically valid.
- Date And Time - Management for date and time objects.
