time.ztech.dev
DEVELOPER

Time API

Simple public JSON endpoints for current time, timezones, conversion, timestamps and calendar data.

Base URL: https://time.ztech.dev/api
GET

GET /api/now

Current UTC time.

curl https://time.ztech.dev/api/now
GET

GET /api/time/{timezone}

Current time for an IANA timezone.

curl https://time.ztech.dev/api/time/Asia/Ho_Chi_Minh
GET

GET /api/time?tz={timezone}

Query-string form of the timezone endpoint.

curl "https://time.ztech.dev/api/time?tz=Asia/Tokyo"
GET

GET /api/utc

UTC time alias.

curl https://time.ztech.dev/api/utc
GET

GET /api/convert

Convert local date/time between timezones. Parameters: from, to, time.

curl "https://time.ztech.dev/api/convert?from=Asia/Ho_Chi_Minh&to=America/New_York&time=2026-10-08T21:00:00"
GET

GET /api/timezones

List IANA timezones. Optional q filter.

curl "https://time.ztech.dev/api/timezones?q=Tokyo"
GET

GET /api/timestamp

Current Unix timestamp.

curl https://time.ztech.dev/api/timestamp
GET

GET /api/timestamp/{unix}

Decode Unix seconds.

curl https://time.ztech.dev/api/timestamp/1791463062
GET

GET /api/calendar/{date}

Calendar metadata for YYYY-MM-DD.

curl https://time.ztech.dev/api/calendar/2026-10-08
GET

GET /api/dst/{timezone}

Current DST state and next transition.

curl https://time.ztech.dev/api/dst/Europe/London
GET

GET /api/difference

Offset difference at the current instant. Parameters: from, to.

curl "https://time.ztech.dev/api/difference?from=Asia/Ho_Chi_Minh&to=America/New_York"
GET

GET /api/ip

Return requester IP and Cloudflare country metadata when available.

curl https://time.ztech.dev/api/ip
GET

GET /api/health

Service health and server time.

curl https://time.ztech.dev/api/health
RESPONSE FORMAT

Predictable JSON

Successful responses return JSON objects. Errors use a consistent error.code and error.message.

{
  "error": {
    "code": "INVALID_TIMEZONE",
    "message": "Unknown IANA timezone: ..."
  }
}

Rate limit

The public MVP allows 60 requests per minute per IP. Rate-limit headers are returned on API requests.

Timezone format

Use IANA identifiers such as Asia/Ho_Chi_Minh, Asia/Tokyo, Europe/London and America/New_York.

No API key

The initial public API is keyless. Authentication and usage dashboards can be added later if traffic requires them.