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

• List Time Zone
• Convert Time Zone

Parameters

Responses

Usage Examples

Get current local time at Statue of Liberty using latitude & longitude

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 Jersey</regionName>
  <cityName>Jersey City</cityName>
  <zoneName>America/New_York</zoneName>
  <abbreviation>EDT</abbreviation>
  <gmtOffset>-14400</gmtOffset>
  <dst>1</dst>
  <zoneStart>1710054000</zoneStart>
  <zoneEnd>1730613600</zoneEnd>
  <nextAbbreviation>EST</nextAbbreviation>
  <timestamp>1715192843</timestamp>
  <formatted>2024-05-08 18:27:23</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 Jersey",
    "cityName": "Jersey City",
    "zoneName": "America\/New_York",
    "abbreviation": "EDT",
    "gmtOffset": -14400,
    "dst": "1",
    "zoneStart": 1710054000,
    "zoneEnd": 1730613600,
    "nextAbbreviation": "EST",
    "timestamp": 1715192843,
    "formatted": "2024-05-08 18:27:23"
}

Get current local time in Chicago, USA

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>CDT</abbreviation>
  <gmtOffset>-18000</gmtOffset>
  <dst>1</dst>
  <zoneStart>1710057600</zoneStart>
  <zoneEnd>1730617199</zoneEnd>
  <nextAbbreviation>CST</nextAbbreviation>
  <timestamp>1715189243</timestamp>
  <formatted>2024-05-08 17:27:23</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": "CDT",
    "gmtOffset": -18000,
    "dst": "1",
    "zoneStart": 1710057600,
    "zoneEnd": 1730617199,
    "nextAbbreviation": "CST",
    "timestamp": 1715189243,
    "formatted": "2024-05-08 17:27:23"
}

Get current local time in Taipei, Taiwan when UTC is 08 May, 2024 10:27:24 PM

http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=zone&zone=Asia/Taipei&time=1715207244

<?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>1715236044</timestamp>
  <formatted>2024-05-09 06:27:24</formatted>
</result>

http://api.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=zone&zone=Asia/Taipei&time=1715207244

{
    "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": 1715236044,
    "formatted": "2024-05-09 06:27:24"
}

Get local time zone for City of Buffalo in US (Premium Subscription Only)

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>FAILED</status>
  <message>Record not found.</message>
  <totalPage>1</totalPage>
  <currentPage>1</currentPage>
  <zones/>
</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": "FAILED",
    "message": "Record not found.",
    "totalPage": 1,
    "currentPage": 1,
    "zones": []
}

Get time zone by IP address with custom fields (Premium Subscription Only)

http://vip.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=xml&by=ip&ip=134.122.106.148&fields=countryCode,cityName,gmtOffset,dst

<?xml version="1.0" encoding="UTF-8"?>
<result>
  <status>OK</status>
  <message/>
  <countryCode>GB</countryCode>
  <cityName>Slough</cityName>
  <gmtOffset>3600</gmtOffset>
  <dst>1</dst>
</result>

http://vip.timezonedb.com/v2.1/get-time-zone?key=YOUR_API_KEY&format=json&by=ip&ip=134.122.106.148&fields=countryCode,cityName,gmtOffset,dst

{
    "status": "OK",
    "message": "",
    "countryCode": "GB",
    "cityName": "Slough",
    "gmtOffset": 3600,
    "dst": "1"
}