Date & Time Toolkit
## Overview The Date & Time Toolkit API provides 28 endpoints for date parsing, time zone conversion, business day calculation, and holiday detection across 20+ countries. ## Key Features - **Date Parsing**: Parse dates from virtually any format with auto-detection - **Time Zone Conversion**: Full IANA timezone database with DST-aware conversion - **Business Days**: Calculate working days with…
Date & Time Toolkit endpoints
| Method | Endpoint | Description |
|---|---|---|
| POST |
Next occurrence of a weekday /calculate/next-weekday |
Find the next occurrence of a given weekday after (or on, if include_same_day=True) the reference date. |
| POST |
Add duration to a date /calculate/add |
Add a combination of days, weeks, months, and/or years to a date. Returns the resulting date along with intermediate steps. |
| POST |
Subtract duration from a date /calculate/subtract |
Subtract a combination of days, weeks, months, and/or years from a date. |
| POST |
Convert date between formats /format/convert |
Convert a date/datetime string from one format to another. Supports auto-detection of input format. Output format can be any of the pre-defined keys or a custom strftime pattern. |
| POST |
Difference between two dates /calculate/difference |
Calculate the difference between two dates in multiple units: days, weeks, months, years, hours, minutes, seconds. |
| POST |
Business days between two dates /calculate/business-days |
Count business days (weekdays excluding weekends and optionally US holidays) between two dates (start inclusive, end exclusive by default). |
| GET |
Calculate age from birthdate /calculate/age |
Calculate exact age in years, months, days (and total days) from a birthdate. |
| POST |
Meeting planner — show time across multiple timezones /timezone/meeting |
Given a meeting datetime in a base timezone, show what time it is in each of the listed participant timezones. Useful for scheduling meetings across international teams. |
| GET |
Generate month calendar grid /calendar/month |
Generate a full month calendar grid. Returns a list of weeks, where each week is a list of 7 day numbers (1–31) with None for slots before the 1st or after the last day. |
| POST |
Previous occurrence of a weekday /calculate/previous-weekday |
Find the previous occurrence of a given weekday before (or on, if include_same_day=True) the reference date. |
| POST |
Parse date string into components /format/parse |
Parse a date string and return all date components: year, month, day, hour, minute, second, day_of_week, day_of_year, week_number, quarter, and is_leap_year. |
| POST |
Convert date to relative time string /format/relative |
Convert a date/datetime to a human-readable relative string. Examples: "just now", "3 minutes ago", "in 2 days", "5 years ago". |
| GET |
Current date/time in multiple formats /format/now |
Return the current UTC date and time formatted in all supported output formats. |
| GET |
List all supported timezones /timezone/list |
Return all supported timezones with their IANA IDs, offsets, abbreviations, and representative cities. |
| POST |
Convert datetime between timezones /timezone/convert |
Convert a datetime from one timezone to another. The input datetime should be a naive string (no Z / offset suffix) and is interpreted as being in `from_timezone`. |
| GET |
Current time in a specific timezone /timezone/current |
Return the current date and time in the specified timezone. |
| GET |
Calendar info for a date /calendar/info |
Return comprehensive calendar metadata for a given date: leap year status, days in month/year, quarter, week number, day of year, and fiscal year. |
| GET |
Generate all dates in a range /calendar/range |
Generate all dates in a range (inclusive on both ends). Optionally step by N days and filter out weekends. Maximum range: 5 years (1826 days) to prevent abuse. |
| GET |
List holidays for a year /holidays/list |
List all federal holidays for the given year and country. Currently supports US federal holidays for any year. |
| GET |
Check if a date is a holiday /holidays/check |
Check whether a specific date is a US federal holiday. Returns holiday details if it is one. |
| GET |
Next upcoming holiday from a date /holidays/next |
Return the next US federal holiday on or after the given date. |
| GET |
Check if a date is a business day /holidays/business-day |
Determine whether a date is a business day. A business day is a weekday (Monday–Friday) that is not a federal holiday. |
| GET |
Current Unix timestamp /epoch/now |
Return the current Unix timestamp in seconds and milliseconds, along with the current UTC datetime in multiple formats. |
| GET |
Convert Unix timestamp to human-readable date /epoch/to-date |
Convert a Unix timestamp to a human-readable date/time in UTC. Supports both seconds (default) and milliseconds precision. |
| GET |
Convert human-readable date to Unix timestamp /epoch/from-date |
Convert a human-readable date/datetime string to a Unix timestamp. The input is treated as UTC. Returns both seconds and milliseconds. |
| GET |
Time elapsed since a Unix timestamp /epoch/since |
Calculate the time elapsed since a given Unix timestamp. Returns elapsed time broken down into seconds, minutes, hours, days, weeks, months, and years. Also provides a… |
| GET |
Root / |
API root — returns name, version, and links to documentation. |
| GET |
Health Check /health |
Health check — returns service status and current UTC time. |
Date & Time Toolkit pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| Pro | $9.99 / month | 20 / minute |
|
| Ultra | $29.99 / month | 100 / minute |
|