Time Zone by Location API
Introduction
This API returns detailed active time zone information for the supplied geolocation coordinates, including daylight saving adjustments if applicable. It will also return the current local time by default, or if supplied with a UTC reference time, it will automatically perform a timezone conversion for you. Powered by patent pending Next Generation IP Geolocation Technology
API Endpoint
| Endpoint: | /data/timezone-by-location |
|---|---|
| Full URL: | https://api.bigdatacloud.net/data/timezone-by-location |
Request Format
|
Order |
Parameter |
Required |
Data type |
Description |
|---|---|---|---|---|
|
1 |
latitude |
Yes |
float |
Location latitude |
|
2 |
longitude |
Yes |
float |
Location longitude |
|
3 |
utcReference |
No |
64 bit integer |
UTC time reference in Unix Time Seconds format. When omitted or invalid, the current time is assumed |
|
4 |
key |
Yes |
string |
Your API key |
Response Format
|
Field |
Data type |
Description |
|---|---|---|
|
ianaTimeId |
string |
Time Zone name in IANA format |
|
displayName |
string |
Display name |
|
effectiveTimeZoneFull |
string |
Effective time zone full name (adjusted to the daylight saving status) |
|
effectiveTimeZoneShort |
string |
Effective time zone short name (adjusted to the daylight saving status) |
|
UtcOffsetSeconds |
32 bit integer |
Effective offset from UTC time in seconds |
|
UtcOffset |
string |
Effective offset from UTC time |
|
isDaylightSavingTime |
boolean |
Indicates if the daylight saving is on |
|
localTime |
string |
Local time in ISO 8601 format |
|
utcTime |
string |
UTC time in ISO 8601 format. Omitted when utcReference parameter was not supplied, or invalid |