thetime.dev OpenAPI 3.1

Public · No authentication

Time, shaped
to fit.

One tiny API for current time, timezone conversion, calendar fields, and any PHP-compatible date format.

Try the API Read the docs
  • 400+IANA zones
  • 24named fields
  • 0API keys
Live / detecting… locating
--:--:--
Connecting to the present…
$ curl "/get.json?timezone=Europe/Berlin&locale=de_AT&field=weekday|dow|dom"
Timezone aware✦ NTP synchronized✦ PHP format strings✦ OpenAPI 3.1✦ JSON & plain text✦

01 / Quickstart

From zero to now
in one request.

Every endpoint is public and accepts a standard IANA timezone such as Europe/Berlin or America/New_York.

01

Pick a field

Ask for one named value or combine several with a pipe or comma.

/get.json?field=weekday|dow|dom
02

Set zone & language

UTC and English are the defaults. Add any locale only when translated names are needed.

&timezone=Europe/Vienna&locale=de_AT
03

Or format it freely

Pass any PHP DateTime::format() pattern and receive the final string.

/get.json?format=Y-m-d H:i:s P
200 OK 
{
  "timezone": "Europe/Berlin",
  "fields": ["weekday", "dow", "dom"],
  "values": {
    "weekday": "Monday",
    "dow": 1,
    "dom": 27
  },
  "timestamp": 1785155405
}

02 / Endpoints

Small surface.
Useful answers.

The original routes and response shapes remain stable. New focused routes sit alongside them.

GET
/get.jsonNew

Named calendar fields or a custom PHP-formatted value.

Query parameters
field
One or more names: weekday|dow|dom
format
PHP format string; cannot be combined with field
timezone / tz
IANA timezone; defaults to UTC
locale
Optional locale such as de_AT; defaults to English
Open in playground
GET
/format.txtNew

Custom formatted current time as a raw text value.

↗
GET
/timezones.jsonNew

Every accepted IANA timezone identifier.

↗
GET
/health.jsonNew

Readiness status for the clock, timezone database, and runtime storage.

↗
GET
/time/{timezone}.jsonStable

The current time in one timezone using the original response shape.

↗
GET
/times.jsonStable

The current time across all supported timezones, grouped by region.

↗
GET
/auto.jsonStable

Timezone and current time inferred from the caller’s IP address.

↗
GET
/plain/{timezone}.txtStable

The original flattened time response as plain text.

↗
GET
/openapi.json3.1

Machine-readable API contract for generators and clients.

↗

03 / Playground

Build a request.
See it tick.

Everything runs against the live API on this host. No account, token, or SDK required.

GET Request
Response mode

Localizes weekday and month names. Leave empty for the unchanged English response.

Fields field
Response
— msReady
{
  "hint": "Send a request to see the live response."
}
application/json

04 / Format reference

Compose time
your way.

All characters supported by PHP’s date() / DateTime::format() are available. With locale, the D, l, M, and F names are localized. Characters not listed are printed as-is.

Pattern l, j F Y · H:i:s P
Result Monday, 27 July 2026 · 14:30:05 +02:00

05 / Build with it

Typed clients,
without the typing.

Import the OpenAPI 3.1 document into Postman, Insomnia, Swagger UI, or your favorite code generator.

{ } OPENAPI
3.1.0
/openapi.json
View specification