Reference: Get Time Zone
http://api.timezonedb.com/v2.1/get-time-zone
Get local time of a city by its name, time zone, latitude & longtiude, or IP address.
Other End Points
http://api.timezonedb.com/v2.1/get-time-zone
Get local time of a city by its name, time zone, latitude & longtiude, or IP address.
Parameter | Description |
key | REQUIRED Your unique API key you get after register your account. |
format |
OPTIONAL The response format from API. It can be either xml or json.
DEFAULT: xml |
callback | OPTIONAL Use for JavaScript JSON callback. |
fields |
OPTIONAL Customize the field to display in response. Use commas ("," without spaces) to separate the field names.
FIELDS: countryCode, countryName, regionName, cityName, zoneName, abbreviation, gmtOffset, dst, zoneStart, zoneEnd, nextAbbreviation, timestamp, formatted DEFAULT: all |
by |
REQUIRED The method of lookup.
|
zone | REQUIRED A time zone abbreviation or time zone name. Required if lookup by zone method. |
lat | REQUIRED Latitude of a city. Required if lookup by position method. |
lng | REQUIRED Longitude of a city. Required if lookup by position method. |
country | REQUIRED A valid ISO 3166 country code. Required if lookup by city method. |
region | OPTIONAL A valid region code of United States. Optional when lookup by city method to limit the search result. |
city | REQUIRED The name of a city. Use asterisk (*) for wildcard search. Required if lookup by city method. |
page | OPTIONAL Navigate to other page when result is more than 10 records. |
time |
OPTIONAL Unix time in UTC.
DEFAULT: Current UTC time. |
Field | Description |
status | Status of the API query. Either OK or FAILED. |
message | Error message. Empty if no error. |
countryCode | Country code of the time zone. |
countryName | Country name of the time zone. |
regionName | PREMIUM Region / State name of the time zone. |
cityName | PREMIUM City / Place name of the time zone. |
zoneName | The time zone name. |
abbreviation | Abbreviation of the time zone. |
gmtOffset | The time offset in seconds based on UTC time. |
dst | Whether Daylight Saving Time (DST) is used. Either 0 (No) or 1 (Yes). |
zoneStart | The Unix time in UTC when current time zone start. |
zoneEnd | The Unix time in UTC when current time zone end. |
timestamp | Current local time in Unix time. Minus the value with gmtOffset to get UTC time. |
formatted | Formatted timestamp in Y-m-d h:i:s format. E.g.: 2021-02-28 10:14:53 |
totalPage | The total page of result when exceed 25 records. |
currentPage | Current page when navigating. |
http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=position&lat=40.689247&lng=-74.044502
<?xml version="1.0" encoding="UTF-8"?> <result> <status>OK</status> <message/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>New York</regionName> <cityName>Statue of Liberty</cityName> <zoneName>America/New_York</zoneName> <abbreviation>EST</abbreviation> <gmtOffset>-18000</gmtOffset> <dst>0</dst> <zoneStart>1604210400</zoneStart> <zoneEnd>1615705200</zoneEnd> <nextAbbreviation>EDT</nextAbbreviation> <timestamp>1614489293</timestamp> <formatted>2021-02-28 05:14:53</formatted> </result>
http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=position&lat=40.689247&lng=-74.044502
{ "status": "OK", "message": "", "countryCode": "US", "countryName": "United States", "regionName": "New York", "cityName": "Statue of Liberty", "zoneName": "America\/New_York", "abbreviation": "EST", "gmtOffset": -18000, "dst": "0", "zoneStart": 1604210400, "zoneEnd": 1615705200, "nextAbbreviation": "EDT", "timestamp": 1614489294, "formatted": "2021-02-28 05:14:54" }
http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=zone&zone=America/Chicago
<?xml version="1.0" encoding="UTF-8"?> <result> <status>OK</status> <message/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName/> <cityName/> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <timestamp>1614485695</timestamp> <formatted>2021-02-28 04:14:55</formatted> </result>
http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=zone&zone=America/Chicago
{ "status": "OK", "message": "", "countryCode": "US", "countryName": "United States", "regionName": "", "cityName": "", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "zoneEnd": 1615708800, "nextAbbreviation": "CDT", "timestamp": 1614485695, "formatted": "2021-02-28 04:14:55" }
http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=zone&zone=Asia/Taipei&time=1614507295
<?xml version="1.0" encoding="UTF-8"?> <result> <status>OK</status> <message/> <countryCode>TW</countryCode> <countryName>Taiwan</countryName> <regionName/> <cityName/> <zoneName>Asia/Taipei</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>28800</gmtOffset> <dst>0</dst> <zoneStart>307551600</zoneStart> <zoneEnd/> <nextAbbreviation/> <timestamp>1614536095</timestamp> <formatted>2021-02-28 18:14:55</formatted> </result>
http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=zone&zone=Asia/Taipei&time=1614507295
{ "status": "OK", "message": "", "countryCode": "TW", "countryName": "Taiwan", "regionName": "", "cityName": "", "zoneName": "Asia\/Taipei", "abbreviation": "CST", "gmtOffset": 28800, "dst": "0", "zoneStart": 307551600, "zoneEnd": null, "nextAbbreviation": null, "timestamp": 1614536095, "formatted": "2021-02-28 18:14:55" }
http://vip.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=city&city=City+of+Buffalo&country=US
<?xml version="1.0" encoding="UTF-8"?> <result> <status>OK</status> <message/> <totalPage>1</totalPage> <currentPage>1</currentPage> <zones/> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>Iowa</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <timestamp>1614485696</timestamp> <formatted>2021-02-28 04:14:56</formatted> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>Kansas</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <timestamp>1614485696</timestamp> <formatted>2021-02-28 04:14:56</formatted> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>Minnesota</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <timestamp>1614485696</timestamp> <formatted>2021-02-28 04:14:56</formatted> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>Missouri</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <timestamp>1614485696</timestamp> <formatted>2021-02-28 04:14:56</formatted> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>North Dakota</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <timestamp>1614485696</timestamp> <formatted>2021-02-28 04:14:56</formatted> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>New York</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/New_York</zoneName> <abbreviation>EST</abbreviation> <gmtOffset>-18000</gmtOffset> <dst>0</dst> <zoneStart>1604210400</zoneStart> <timestamp>1614489296</timestamp> <formatted>2021-02-28 05:14:56</formatted> <zoneEnd>1615705200</zoneEnd> <nextAbbreviation>EDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>Texas</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Chicago</zoneName> <abbreviation>CST</abbreviation> <gmtOffset>-21600</gmtOffset> <dst>0</dst> <zoneStart>1604214000</zoneStart> <timestamp>1614485696</timestamp> <formatted>2021-02-28 04:14:56</formatted> <zoneEnd>1615708800</zoneEnd> <nextAbbreviation>CDT</nextAbbreviation> <zone/> <countryCode>US</countryCode> <countryName>United States</countryName> <regionName>Wyoming</regionName> <cityName>City of Buffalo</cityName> <zoneName>America/Denver</zoneName> <abbreviation>MST</abbreviation> <gmtOffset>-25200</gmtOffset> <dst>0</dst> <zoneStart>1604217600</zoneStart> <timestamp>1614482096</timestamp> <formatted>2021-02-28 03:14:56</formatted> <zoneEnd>1615712400</zoneEnd> <nextAbbreviation>MDT</nextAbbreviation> </result>
http://vip.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=city&city=City+of+Buffalo&country=US
{ "status": "OK", "message": "", "totalPage": 1, "currentPage": 1, "zones": [ { "countryCode": "US", "countryName": "United States", "regionName": "Iowa", "cityName": "City of Buffalo", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "timestamp": 1614485697, "formatted": "2021-02-28 04:14:57", "zoneEnd": 1615708800, "nextAbbreviation": "CDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "Kansas", "cityName": "City of Buffalo", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "timestamp": 1614485697, "formatted": "2021-02-28 04:14:57", "zoneEnd": 1615708800, "nextAbbreviation": "CDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "Minnesota", "cityName": "City of Buffalo", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "timestamp": 1614485697, "formatted": "2021-02-28 04:14:57", "zoneEnd": 1615708800, "nextAbbreviation": "CDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "Missouri", "cityName": "City of Buffalo", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "timestamp": 1614485697, "formatted": "2021-02-28 04:14:57", "zoneEnd": 1615708800, "nextAbbreviation": "CDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "North Dakota", "cityName": "City of Buffalo", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "timestamp": 1614485697, "formatted": "2021-02-28 04:14:57", "zoneEnd": 1615708800, "nextAbbreviation": "CDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "New York", "cityName": "City of Buffalo", "zoneName": "America\/New_York", "abbreviation": "EST", "gmtOffset": -18000, "dst": "0", "zoneStart": 1604210400, "timestamp": 1614489297, "formatted": "2021-02-28 05:14:57", "zoneEnd": 1615705200, "nextAbbreviation": "EDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "Texas", "cityName": "City of Buffalo", "zoneName": "America\/Chicago", "abbreviation": "CST", "gmtOffset": -21600, "dst": "0", "zoneStart": 1604214000, "timestamp": 1614485697, "formatted": "2021-02-28 04:14:57", "zoneEnd": 1615708800, "nextAbbreviation": "CDT" }, { "countryCode": "US", "countryName": "United States", "regionName": "Wyoming", "cityName": "City of Buffalo", "zoneName": "America\/Denver", "abbreviation": "MST", "gmtOffset": -25200, "dst": "0", "zoneStart": 1604217600, "timestamp": 1614482097, "formatted": "2021-02-28 03:14:57", "zoneEnd": 1615712400, "nextAbbreviation": "MDT" } ] }
http://vip.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=ip&ip=54.236.58.220&fields=countryCode,cityName,gmtOffset,dst
<?xml version="1.0" encoding="UTF-8"?> <result> <status>OK</status> <message/> <countryCode>US</countryCode> <cityName>Ashburn</cityName> <gmtOffset>-18000</gmtOffset> <dst>0</dst> </result>
http://vip.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=ip&ip=54.236.58.220&fields=countryCode,cityName,gmtOffset,dst
{ "status": "OK", "message": "", "countryCode": "US", "cityName": "Ashburn", "gmtOffset": -18000, "dst": "0" }