What is chronic?

Chronic is a Ruby library that takes human-friendly date and time phrases like "next Friday at 5pm" or "3 years ago" and converts them into structured dates a computer can use. It bridges the gap between how people naturally talk about time and how software needs to store it. When you pass a string to Chronic, it attempts to figure out the date and time you meant. It handles a huge range of formats, from simple expressions like "tomorrow" or "yesterday" to complex ones like "3rd Wednesday in November" or "fourteenth of June 2010 at eleven o'clock in the evening." It is case insensitive, tolerates common misspellings, and handles abbreviations. If it cannot make sense of a phrase, it simply returns nil rather than raising an error. You can also provide context hints, like whether an ambiguous phrase like "monday" should refer to the past or future, and specify how dates should be interpreted. This is useful for anyone building a Ruby app that needs to accept user input about dates in a flexible way. Imagine a task manager where users type "remind me next Tuesday at 3pm" or a scheduling tool where someone enters "last Friday at 20:00." Instead of forcing users to pick dates from a calendar widget or type in a strict format like MM/DD/YYYY, you can let them write naturally and let Chronic sort out what they meant. One notable aspect is its handling of time zones. By default it uses your system's local time zone, but you can plug in a more capable time zone class (like the one from Rails' ActiveSupport) to get full time zone awareness. The README does note a limitation: it relies on Ruby's built-in Time class, so dates outside of that class's supported range will fail to parse and return nil.