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

Geolocation

ip
string

The IP address that was looked up

Example: 8.8.8.8
latitude
number|null

Latitude coordinate

Example: 37.386
longitude
number|null

Longitude coordinate

Example: -122.084
accuracy_radius
integer|null

Accuracy radius in kilometers

Example: 1000
timezone
string|null

The timezone for the location

Example: America/Los_Angeles
city
string

The city name

Example: Mountain View
postal_code
string

The postal/zip code

Example: 94043
metro_code
integer

The metro code

Example: 807
subdivisions
array

Array of subdivision objects with code and name

Example: [{"code": "CA", "name": "California"}]
country
object

Country information with iso_code, name, and is_in_european_union flag

Example: {"iso_code": "US", "name": "United States", "is_in_european_union": false}
continent
object

Continent information with code and name

Example: {"code": "NA", "name": "North America"}
is_in_european_union
boolean

Whether the IP is in the European Union

Example: false
is_anonymous_proxy
boolean

Whether the IP is an anonymous proxy

Example: false
is_satellite_provider
boolean

Whether the IP is from a satellite provider

Example: false
is_anycast
boolean

Whether the IP is an anycast address

Example: false
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").