Chronos
Everything you need for date math in a single API. Differences, business days, age, countdowns, holidays, timezone-aware calculations and batch processing
2 subscribers
9.1/10 popularity
635 ms avg latency
100% success rate
11 endpoints
The in-depth APIMemo review for this API hasn't been published yet —
the data below comes straight from the public marketplace listing.
Chronos endpoints
| Method | Endpoint | Description |
|---|---|---|
| Dates | ||
| GET |
addDays /v1/add-days |
Adds (or subtracts, if negative) N days to a date. When `skip_weekends=true`, only business days are counted, respecting holidays for the given country and state. |
| GET |
getAge /v1/age |
Calculates exact age from a birthdate — years, months and days — plus next birthday info and total days lived. |
| GET |
getNextWorkday /v1/next-workday |
Returns the next business day after a given date, along with info about whether the input date itself is a workday, holiday or weekend. |
| GET |
getWorkdays /v1/workdays |
Counts business days between two dates, excluding weekends and public holidays. Supports national and state-level holidays for Brazil. |
| GET |
getCountdown /v1/countdown |
Returns how many days remain until (or have passed since) a target date, with a translated human-readable label. |
| GET |
getDifference /v1/difference |
Returns the complete difference between two dates in all units — days, weeks, months, years, hours, minutes, seconds — plus a human-readable breakdown. |
| Holidays | ||
| GET |
getHolidays /v1/holidays |
Returns all public holidays for a given year and country. For Brazil, pass a `state` code to also include state-level holidays. |
| Timezones | ||
| GET |
getTimezones /v1/timezones |
Returns all 418 IANA timezones supported by the server, each with its current UTC offset. Optionally filter by region. **No API key required.** |
| GET |
getTimezone /v1/timezone |
Calculates the real elapsed time between two datetime strings, each interpreted in its own timezone. Returns the UTC equivalent of each, the difference, and the offset gap… |
| Batch | ||
| POST |
postBatch /v1/batch |
Process multiple date pairs in a single request. **Pro plan: up to 50 pairs. Enterprise plan: up to 500 pairs. Not available on Free tier.** |
| Meta | ||
| GET |
getLanguages /v1/languages |
Returns all supported language codes for the `?lang=` parameter. **No API key required.** |
Chronos pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $9 / month | — |
|
| ULTRA | $49 / month | — |
|
