Time Zone API and Time Zone Lookup by IP
IPGeolocation.io's free Time Zone API and Time Conversion API provide date and time information such as current time, date in various formats, week, month, year, Unix timestamps, UTC/GMT offset and daylight saving time from a time zone name, any IPv4 or IPv6 address or geolocation coordinates in JSON and XML format over a secure HTTPS connection. The API also calculates precise time differences in hours and minutes between two locations using time zone, coordinates, or city.
ip:"216.73.216.193",
location:Object,
continent_code:"NA",
continent_name:"North America",
country_code2:"US",
country_code3:"USA",
country_name:"United States",
country_name_official:"United States of America",
is_eu:false,
state_prov:"Ohio",
state_code:"US-OH",
district:"Franklin",
city:"Columbus",
zipcode:"43215",
latitude:"39.96199",
longitude:"-83.00275",
time_zone:Object,
name:"America/New_York",
offset:-5,
offset_with_dst:-5,
date:"2026-11-21",
date_time:"2026-11-21 03:36:31",
date_time_txt:"Saturday, November 21, 2026 03:36:31",
date_time_wti:"Sat, 21 Nov 2026 03:36:31 -0500",
date_time_ymd:"2026-11-21T03:36:31-0500",
current_time:"2026-11-21 03:36:31.581-0500",
current_time_unix:1795250191.581,
time_24:"03:36:31",
time_12:"03:36:31 AM",
week:47,
month:11,
year:2026,
year_abbr:"26",
current_tz_abbreviation:"EST",
current_tz_full_name:"Eastern Standard Time",
standard_tz_abbreviation:"EST",
standard_tz_full_name:"Eastern Standard Time",
is_dst:false,
dst_savings:0,
dst_exists:true,
dst_tz_abbreviation:"EDT",
dst_tz_full_name:"Eastern Daylight Time",
dst_start:Object,
utc_time:"2027-03-14 TIME 07:00",
duration:"+1.00H",
gap:true,
date_time_after:"2027-03-14 TIME 03:00",
date_time_before:"2027-03-14 TIME 02:00",
overlap:false,
dst_end:Object,
utc_time:"2027-11-07 TIME 06:00",
duration:"-1.00H",
gap:false,
date_time_after:"2027-11-07 TIME 01:00",
date_time_before:"2027-11-07 TIME 02:00",
overlap:true,
Detailed Time Zone Data
Detailed time zone data consists of comprehensive information about the current time and date, presented in multiple formats. It also covers time zone offset values, daylight saving details like start and end times, any gaps or overlaps, and whether DST is active. Optionally, this data can be enriched with geolocation information when IP-based time zone detection is requested.
{
"time_zone": {
"name": "Australia/Lord_Howe",
"offset": 10.5,
"offset_with_dst": 11,
"date": "2026-10-29",
"date_time": "2026-10-29 21:33:55",
"date_time_txt": "Thursday, October 29, 2026 21:33:55",
"date_time_wti": "Thu, 29 Oct 2026 21:33:55 +1100",
"date_time_ymd": "2026-10-29T21:33:55+1100",
"current_time": "2026-10-29 21:33:55.564+1100",
"current_time_unix": 1793270035.564,
"time_24": "21:33:55",
"time_12": "09:33:55 PM",
"week": 44,
"month": 10,
"year": 2026,
"year_abbr": "26",
"current_tz_abbreviation": "LHDT",
"current_tz_full_name": "Lord Howe Daylight Time",
"standard_tz_abbreviation": "LHST",
"standard_tz_full_name": "Lord Howe Standard Time",
"is_dst": true,
"dst_savings": 0.5,
"dst_exists": true,
"dst_tz_abbreviation": "LHDT",
"dst_tz_full_name": "Lord Howe Daylight Time",
"dst_start": {
"utc_time": "2026-10-03 TIME 15:30",
"duration": "+0.50H",
"gap": true,
"date_time_after": "2026-10-04 TIME 02:30",
"date_time_before": "2026-10-04 TIME 02:00",
"overlap": false
},
"dst_end": {
"utc_time": "2027-04-03 TIME 15:00",
"duration": "-0.50H",
"gap": false,
"date_time_after": "2027-04-04 TIME 01:30",
"date_time_before": "2027-04-04 TIME 02:00",
"overlap": true
}
}
}Geolocation Module
When the Time Zone API is called without any parameter, with an IP address or with a location address, it returns geolocation information for that location, along with the time zone data.
{
"location": {
"continent_code": "EU",
"continent_name": "Europe",
"country_code2": "DE",
"country_code3": "DEU",
"country_name": "Germany",
"country_name_official": "Federal Republic of Germany",
"is_eu": true,
"state_prov": "Bavaria",
"state_code": "DE-BY",
"district": "Cham",
"city": "Falkenstein",
"zipcode": "93167",
"latitude": "49.09745",
"longitude": "12.48637"
}
}Get Airport details from IATA or ICAO codes
The Time Zone API can retrieve detailed airport information along with time zone data using IATA or ICAO codes. The response includes the airport type, name, geo coordinates, elevation, continent, country and state codes, city, and IATA, ICAO, and FAA codes (if available), providing a complete profile of the airport's location and time zone.
{
"airport_details": {
"type": "large_airport",
"name": "London Heathrow Airport",
"latitude": "51.47060",
"longitude": "-0.46194",
"elevation_ft": 83,
"continent_code": "EU",
"country_code": "GB",
"state_code": "GB-ENG",
"city": "London",
"iata_code": "LHR",
"icao_code": "EGLL",
"faa_code": ""
}
}Get City Level Information from UN/LOCODE
Our Time Zone API can be queried with a UN/LOCODE to provide city-level information, including the UN/LOCODE, location type, and geographic coordinates, along with relevant time zone data.
{
"lo_code_details": {
"lo_code": "DEBER",
"city": "Berlin",
"state_code": "BE",
"country_code": "DE",
"country_name": "",
"location_type": "Port, Rail Terminal, Road Terminal, Airport, Postal Exchange",
"latitude": "52.51667",
"longitude": "13.38333"
}
}Convert Time / Calculate Time Difference
Our Time Zone API sub-feature can calculate the time difference between two locations based on their time zone names, geo coordinates, or city address locations.
{
"original_time": "2026-12-08 11:00:00",
"converted_time": "2026-12-08 18:30:00",
"diff_hour": 7.5,
"diff_min": 450
}Response in Multiple Languages
You can retrieve the geolocation information for an IP address in the following languages:
-
English
-
German
-
Russian
-
Japanese
-
French
-
Chinese Simplified
-
Spanish
-
Czech
-
Italian
-
Korean
-
Persian
-
Portuguese
-
Standard Arabic
Use Cases
Travel Across Time Zones
Build an application for travelers who move a lot between different time zones! Use the Time Zone API to keep their clocks right, however many time zones they cross.
E-commerce
Know where in the world your buyers are and show them the right message at the right time of their day.
Global Communication
For teams that work from all over the globe, make communications a piece of cake using our free time zone API.
Flight Management
Airline platforms can build systems that show passengers accurate flight departure and arrival times in their own time zones, helping them avoid any confusion and better plan their travel.
Ready to get started? Add Time Zone API to your stack today
Get accurate local time, UTC offsets, daylight-saving information, and time zone data for locations around the world. Build reliable scheduling, communication, and time-aware applications with the Time Zone API.