Documentation

A clean docs surface with the full public API behind it.

Start with the operational rules, then move into endpoint-level detail, raw Swagger, and SEO-targeted guides for the most common time and timezone workflows.

Quickstart

Get a single request working with RapidAPI headers, a base URL, and one successful response example.

Open quickstart

Concepts

Understand selector families, bulk mode limits, signed responses, and the embeddable clock model before you branch into routes.

Open concepts

Endpoints

Every public operation gets natural-language explanation, parameter notes, code tabs, and expandable deep detail.

Open endpoints
Concepts

Selector families and target resolution

Choose one target strategy per request and keep that rule consistent across your integration.

Read concept

Bulk mode, partial failures, and error handling

Bulk mode is intentionally narrow, and per-item failures should be treated differently from request-level errors.

Read concept

Signed JSON responses and verification

Signing is optional, explicit, and documented as a verification workflow rather than a generic response flag.

Read concept

Embeddable clock output and style selection

The clock route is an output feature, not a JSON helper, and the docs should reflect that difference clearly.

Read concept
Endpoints

Public signing key set

Use this route when a downstream service needs to verify signed JSON responses from the public API.

GET /.well-known/time-api-public-key
Open endpoint

Get the current time for a target

Use this route to validate selector resolution and inspect the canonical single-target time payload.

GET /v1/time/current
Open endpoint

Convert a timestamp into a target timezone or offset

Use conversion when you already know the source instant and need the target rendered in another timezone or offset.

GET /v1/time/convert
Open endpoint

Difference between two instants

Use diff when you need the distance between two explicit instants rather than a relative now-to-target calculation.

GET /v1/time/diff
Open endpoint

Add modifiers to a timestamp

Use add when you want the API to shift a timestamp by explicit modifiers and then resolve the result in a target context.

GET /v1/time/add
Open endpoint

Calendar projection for a target instant

Use calendar projection when you want structured calendar fields for a target instant rather than only a formatted timestamp.

GET /v1/time/calendar
Open endpoint

Daylight-saving status for a target

Use DST status when offset change awareness matters to scheduling, billing windows, or user-facing time displays.

GET /v1/time/dst
Open endpoint

Render a live HTML clock

Use the clock route when you want embeddable HTML output instead of building and styling a live clock component yourself.

GET /v1/time/clock
Open endpoint

Time elapsed since or remaining until a reference instant

Use elapsed when you need time since or time until a reference instant, optionally relative to another explicit comparison instant.

GET /v1/time/elapsed
Open endpoint

Resolve timezone information for a target

Use timezone resolution when the main question is zone identity and metadata rather than the formatted current time.

GET /v1/timezone
Open endpoint
Guides

World Time API for production apps

How to evaluate a world time API when you need more than a bare UTC conversion utility.

Read Guide

Timezone Lookup API by IANA zone, IP, coordinates, or offset

The strongest timezone APIs make input strategy and ambiguity handling clear before you ship.

Read Guide

UTC, Unix, and wall-clock timestamp conversion API

Conversion is where timestamp inputs, source timezone context, and formatting choices start to matter.

Read Guide

DST and business-day calculations API

Daylight-saving changes and business-day logic are where time APIs stop being trivial utilities.

Read Guide