# mojombo/chronic

Chronic is a pure Ruby natural language date parser.

Repository: https://github.com/mojombo/chronic
Canonical: https://ross.abutalabs.com/products/chronic
Homepage: http://injekt.github.com/chronic
Language: Ruby
License: MIT
License Family: permissive
Last push: 2023-09-28T02:41:20+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 6791, "days_push": 1070, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3254, forks 449 (observed 2026-08-28T04:07:52.203407+00:00)

## What it is
Chronic is a pure Ruby natural language date and time parser that converts phrases like 'tomorrow at 6:45pm' or '3rd wednesday in november' into Time objects or time spans. It handles a wide variety of formats, abbreviations, misspellings, and configurable options like endian precedence and ambiguous time ranges.

## Use cases
- parse natural language dates like 'tomorrow' or 'next friday' in ruby
- convert user-typed date strings into time objects
- parse phrases like '3 hours ago' or 'next month' into timestamps
- handle flexible date input in scheduling apps
- parse ambiguous date formats with endian precedence control

## When to choose
- you need to parse human-written date/time phrases in a Ruby project
- users supply free-form dates like 'next tuesday 5pm' that must be interpreted
- you want a pure Ruby gem with no native dependencies

## When to avoid
- you need parsing in a non-Ruby language
- you only need to parse strict machine formats like ISO 8601 (use standard date libraries)
- you need actively developed features or recent bug fixes

## Facets
- artifact type: library
- maturity: maintenance
- function: parser, date-time, nlp
- domain: developer-tools, web-development
- platform: ruby, cross-platform
- tags: date-parsing, natural-language-dates, time-parsing, ruby-gem, natural-language-processing

## Member repositories
- mojombo/chronic (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:52.203407+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-30T07:24:23.830178+00:00, confidence not recorded.
  - readme: https://github.com/mojombo/chronic (fetched 2026-08-28T04:07:52.203407+00:00, sha 1092966cf156)
- Data as of 2026-08-30T08:39:29.467469+00:00.