Time zone conversion API guide
Convert Unix, Unix-millisecond, or ISO timestamps into timezone-aware JSON responses.
How do I convert a timestamp between timezones?
Use /v1/time/convert as a time zone conversion API, date time conversion API, or UTC conversion API with exactly one input form (unix, unix_ms, or iso) and one target selector such as tz, ip, lat plus lon, offset, or utc.
curl "https://api.timelogicapi.com/v1/time/convert?iso=2026-04-16T09:00:00&source_tz=America/New_York&tz=Europe/Paris" \
-H "Authorization: Bearer $TIMELOGIC_API_KEY"
Input and target rules
Provide exactly one input timestamp:
| Input | Meaning |
|---|---|
unix | Unix seconds. |
unix_ms | Unix milliseconds. |
iso | ISO 8601, with an offset or a source hint for a local wall time. |
Then provide exactly one target family: tz, ip, lat + lon, offset, or utc=true. Combining target families, or mixing utc=true with a bulk target, returns AMBIGUOUS_TARGET.
Local ISO values and source hints
An ISO value such as 2026-04-16T09:00:00 has no offset. Tell the API how to interpret that wall time with one source hint:
GET /v1/time/convert?iso=2026-04-16T09:00:00&source_tz=America/New_York&tz=Europe/Paris
Use source_ip, source_lat + source_lon, or source_offset when those are the inputs available to your application. An ISO value with Z or an explicit numeric offset is already an instant and does not need a source hint.
Formatting, history, and date math
Use format for an additional strftime-style formatted field. Unix timestamp conversion and historical time conversion use the supplied instant rather than the current clock. The response preserves that instant and supplies UTC, local ISO, RFC 2822, Unix, and calendar fields. For date math and date arithmetic, use /v1/time/add, /v1/time/diff, or /v1/time/elapsed.
Bulk conversion
Send comma-separated targets within one selector family to receive an array in input order. Keep the input timestamp fixed and let the response provide the target timezone and local representation for each item. See conversion endpoint documentation and bulk mode.