# Time Zones and Dates

Exact time zone conversion, DST transitions, meeting overlap, business days, date differences and ISO weeks.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://timezone-time.x402tookit.com/openapi.json
- x402 manifest: https://timezone-time.x402tookit.com/.well-known/x402
- Catalog (free): https://timezone-time.x402tookit.com/catalog
- Health (free): https://timezone-time.x402tookit.com/health
- Uptime (free): https://timezone-time.x402tookit.com/uptime

## Endpoints (9)

### GET /age-calc — $0.02
Exact age in years, months and days from a birth date as of a date, plus next birthday and days until it.
Params: birth_date: string, as_of?: string
Example: https://timezone-time.x402tookit.com/age-calc?birth_date=1990-02-28&as_of=2026-10-11

### GET /business-days — $0.02
Add business days to a date or count the business days between two dates, Monday-Friday, skipping holidays you list.
Params: start: string, add_days?: integer, end?: string, holidays?: string
Example: https://timezone-time.x402tookit.com/business-days?start=2026-10-09&add_days=5&holidays=2026-10-12

### GET /date-diff — $0.02
Exact difference between two dates as years, months and days, plus total days, weeks and whole months.
Params: start: string, end: string
Example: https://timezone-time.x402tookit.com/date-diff?start=2024-02-28&end=2026-10-11

### GET /dst-info — $0.02
Daylight saving transitions of an IANA time zone in a year: exact UTC instants, offsets before and after, and the clock change.
Params: tz: string, year?: integer
Example: https://timezone-time.x402tookit.com/dst-info?tz=America%2FNew_York&year=2026

### GET /meeting-planner — $0.02
Find the meeting hours where everyone is within working hours across up to 6 time zones on a date, with local times.
Params: zones: string, date?: string, start_hour?: integer, end_hour?: integer
Example: https://timezone-time.x402tookit.com/meeting-planner?zones=America%2FNew_York%2CEurope%2FLondon%2CAsia%2FKolkata&date=2026-01-15&start_hour=9&end_hour=17

### GET /time-convert — $0.02
Convert a date and time from one IANA time zone to another, flagging times that do not exist or occur twice at DST changes.
Params: datetime: string, from_tz: string, to_tz: string
Example: https://timezone-time.x402tookit.com/time-convert?datetime=2026-07-04T15%3A30&from_tz=America%2FNew_York&to_tz=Asia%2FTokyo

### GET /time-now — $0.02
Current date and time in an IANA time zone, with UTC offset, abbreviation and whether daylight saving time is in effect.
Params: tz: string
Example: https://timezone-time.x402tookit.com/time-now?tz=America%2FNew_York

### GET /tz-offset-diff — $0.02
Hours of difference between two IANA time zones on a given date, with each offset, accounting for daylight saving.
Params: a: string, b: string, date?: string
Example: https://timezone-time.x402tookit.com/tz-offset-diff?a=America%2FLos_Angeles&b=Europe%2FLondon&date=2026-03-20

### GET /week-number — $0.02
ISO 8601 week number and week year, day of the year, quarter, weekday and leap-year status for a date.
Params: date?: string
Example: https://timezone-time.x402tookit.com/week-number?date=2026-01-01

## Terms

Results are computed locally from the IANA time zone database built into the server runtime, provided as is. Time zone rules change by law, sometimes at short notice; check for recent changes before relying on a future date. Business-day counts ignore public holidays unless stated.