API Response Schema

The World Time API response format in a nutshell

DateTime

abbreviation
string

The abbreviated name of the timezone

Example: EDT
datetime
string

The current date and time

Example: 2025-08-03T08:39:35.923-04:00
day_of_week
integer

The day of the week (0=Sunday, 1=Monday, etc.)

Example: 0
day_of_year
integer

The day of the year (1-366)

Example: 215
dst
boolean

Whether the local time is in daylight savings

Example: true
dst_from
string|null

When DST is active: indicates when the current DST period started. When DST is NOT active: indicates when the next DST period will begin (future date). Returns null if the timezone does not observe DST.

Example: 2025-03-09T07:00:00+00:00
dst_offset
integer

The difference in seconds between the current local time and daylight saving time

Example: 3600
dst_until
string|null

When DST is active: indicates when the current DST period will end (future date). When DST is NOT active: indicates when the last DST period ended (past date). Returns null if the timezone does not observe DST.

Example: 2025-11-02T06:00:00+00:00
raw_offset
integer

The difference in seconds between the current local time and the time in UTC, excluding any daylight saving difference (see dst_offset)

Example: -18000
timezone
string

The timezone

Example: America/New_York
unixtime
integer

The number of seconds since the unix Epoch

Example: 1754224775
utc_datetime
string

The current UTC date and time

Example: 2025-08-03T12:39:35.923+00:00
utc_offset
string

The UTC offset in ±HH:MM format

Example: -04:00
week_number
integer

The ISO week number (1-53)

Example: 31
client_ip
string

The IP address of the client making the request

Example: 127.0.0.1
Formatting notes

ISO 8601 Format

All datetime fields follow the ISO 8601 standard:

YYYY-MM-DDTHH:MM:SS.ssssss±HH:MM

Unix Timestamp

The unixtime field represents seconds since January 1, 1970 (Unix epoch).

Timezone Identifiers

Timezone identifiers follow the IANA Time Zone Database format (e.g., "America/New_York", "Europe/London").