# MatthewYork/DateTools

Dates and times made easy in iOS

Repository: https://github.com/MatthewYork/DateTools
Canonical: https://ross.abutalabs.com/products/datetools
Language: Objective-C
License: MIT
License Family: permissive
Last push: 2024-08-21T17:55:53+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4550, "days_push": 742, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7178, forks 938 (observed 2026-08-28T04:09:56.438676+00:00)

## What it is
DateTools is an Objective-C and Swift library that simplifies date and time handling in iOS, inspired by .NET's DateTime and Time Period Library. It removes boilerplate for accessing date components, enables nuanced date comparisons, and introduces time period concepts and collections.

## Use cases
- format dates in an ios app without boilerplate
- compare and manipulate nsdate values easily
- work with time periods and intervals in swift
- get localized relative time strings like '2 hours ago'
- simplify date component extraction on ios

## When to choose
- you are building an ios app in objective-c or swift and need ergonomic date handling
- you want time period abstractions not offered by foundation
- you prefer a lightweight, battle-tested pod used by major apps

## When to avoid
- you are targeting android, web, or server-side platforms
- you need a cross-platform date library
- your project is pure Swift and you prefer modern Swift-native date APIs like SwiftDate or Foundation's newer APIs

## Facets
- artifact type: library
- maturity: maintenance
- function: date-time
- domain: mobile-development, developer-tools
- platform: -
- tags: objective-c, cocoapods, time-periods, date-formatting, ios, swift, mobile

## Member repositories
- MatthewYork/DateTools (main) score 23

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:56.438676+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:39:55.487883+00:00, confidence not recorded.
  - readme: https://github.com/MatthewYork/DateTools (fetched 2026-08-28T04:09:56.438676+00:00, sha c2969a51613c)
- Data as of 2026-08-30T08:39:29.467469+00:00.