TimeAPI
App · 11 actions
Get the current time anywhere: in any time zone, at a place on the map or for a visitor's IP address. Convert a date and time between time zones with daylight saving time handled, add or subtract days and hours, find the day of the week or of the year for a date, look up a time zone's offsets and daylight saving dates, and write dates out in 134 languages. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Add or subtract time | Add days, hours, minutes and seconds to a date and time, or subtract them, in a time zone: for example 3 days and 4 hours from now in Tokyo. |
| Convert a time to another time zone | Convert a date and time from one time zone to another, with daylight saving time taken into account on both sides: for example 14:00 in New York to the time in Tokyo. |
| Get the current time at a location | Find the time zone of a place on the map from its latitude and longitude, and the date and time there right now. |
| Get the current time for an IP address | Find the time zone of a public IPv4 address, such as a website visitor's, and the date and time there right now. |
| Get the current time in a time zone | Get the date and time right now in any time zone: the local date, the clock time, the day of the week, the UTC offset, whether daylight saving time is on, and the same moment in UTC. |
| Get the current Unix time | Get the current Unix timestamp (time since 1 January 1970 in UTC) in seconds, milliseconds or microseconds, with the same moment as UTC text. |
| Get the day of the week | Find which day of the week a date falls on, its number in the week (1 for Monday to 7 for Sunday) and whether it's a weekend. |
| Get the day of the year | Find which day of its year a date is (1 to 366), how many days that year has, how many are left after it, and whether it's a leap year. |
| Get time zone details | Get a time zone's details: its UTC offset now and in standard time, whether it uses daylight saving time, when that starts and ends, and its current local time. |
| List time zones | List the time zones TimeAPI knows (about 600), by their standard names such as America/New_York, which is what every time zone field takes. |
| Translate a date | Write a date and time out in words in another language, the way that language writes dates: for example Sonntag, 14. |
Add or subtract time
Add days, hours, minutes and seconds to a date and time, or subtract them, in a time zone: for example 3 days and 4 hours from now in Tokyo. Leave the start empty to start from the current time. Time is counted as it passes, so across a clock change the result's clock time shifts by the hour that was skipped or repeated. No API key required.
Inputs
- Add or subtract
operationtext - Whether to go forward in time (add) or back (subtract). Add if left empty.One of:
add,subtract. Default:add. - Days
daysnumber - How many days. Decimals are fine: 0.5 is 12 hours.From 0 to 36525.
- Hours
hoursnumber - How many hours, any number: 36 is a day and a half.From 0 to 876600.
- Minutes
minutesnumber - How many minutes, any number: 90 is an hour and a half.From 0 to 52596000.
- Seconds
secondsnumber - How many seconds, any number, with decimals for parts of a second.From 0 to 3155760000.
- Time zone
time_zonetextRequired - The time zone to calculate in, which is also the zone the result is given in. The time zone, by its standard name such as Europe/London or America/New_York. Pick it from the list, which holds every zone TimeAPI knows.
- Start from
date_timedate and time - The date and time to start from. Leave it empty to start from the current time in the time zone. A time picked with the picker is the moment you picked; text without a zone, such as 2026-03-15 14:00, is read as local time in the time zone.
- If the time happens twice
if_ambiguoustext - When the clocks go back, the hour before the change happens twice, so a time such as 01:30 that night names two moments. Say which one is meant. Only needed for a time typed as text: a time picked with the picker is already one exact moment. Leave it empty and such a time fails the step with a message saying so.One of:
earlier(The first one (before the clocks go back)),later(The second one (after the clocks go back)).
Outputs
datetext- The date on the local calendar, as YYYY-MM-DD.
date_timetext- The date and time with its UTC offset, such as 2026-10-20T05:04:01+02:00, ready for any other step's date field.
day_of_weektext- The local day of the week in English, such as Tuesday.
dst_activetrue/false- True when daylight saving (summer) time is in force then.
durationtext- The time added or subtracted, in words, such as 2 days and 3 hours.
duration_secondsnumber- The same amount of time in seconds.
operationtext- add or subtract.
started_fromtext- The date and time the calculation started from, with its offset.
started_from_nowtrue/false- True when it started from the current time.
summarytext- One sentence with the calculation and its result.
timetext- The local clock time, as HH:MM:SS on a 24-hour clock.
time_zonetext- The time zone the calculation was made in.
unix_timestampnumber- The same moment as a Unix timestamp, in seconds.
utc_offsettext- How far the local clock is from UTC at that moment, such as +02:00 or -04:00.
utc_offset_secondsnumber- The same offset in seconds, such as 7200.
utc_timetext- The same moment in UTC, such as 2026-10-20T03:04:01Z.
Example output
{
"date": "2026-03-08",
"date_time": "2026-03-08T13:00:00-04:00",
"day_of_week": "Sunday",
"dst_active": true,
"duration": "1 day",
"duration_seconds": 86400.0,
"operation": "add",
"started_from": "2026-03-07T12:00:00-05:00",
"started_from_now": false,
"summary": "1 day after 12:00 on Saturday 7 March 2026 is 13:00 on Sunday 8 March 2026 in America/New_York.",
"time": "13:00:00",
"time_zone": "America/New_York",
"unix_timestamp": 1772989200,
"utc_offset": "-04:00",
"utc_offset_seconds": -14400,
"utc_time": "2026-03-08T17:00:00Z"
}Convert a time to another time zone
Convert a date and time from one time zone to another, with daylight saving time taken into account on both sides: for example 14:00 in New York to the time in Tokyo. Returns the new date, time, day of the week and offset, and the same moment in UTC. No API key required.
Inputs
- Date and time
date_timedate and timeRequired - The date and time to convert. A time picked with the picker is the moment you picked, in your own time zone. Text without a zone, such as 2026-03-15 14:00 from a form, is read as local time in the From time zone.
- From time zone
from_time_zonetextRequired - The time zone the date and time is in. The time zone, by its standard name such as Europe/London or America/New_York. Pick it from the list, which holds every zone TimeAPI knows.
- To time zone
to_time_zonetextRequired - The time zone to convert it to. The time zone, by its standard name such as Europe/London or America/New_York. Pick it from the list, which holds every zone TimeAPI knows.
- If the time happens twice
if_ambiguoustext - When the clocks go back, the hour before the change happens twice, so a time such as 01:30 that night names two moments. Say which one is meant. Only needed for a time typed as text: a time picked with the picker is already one exact moment. Leave it empty and such a time fails the step with a message saying so.One of:
earlier(The first one (before the clocks go back)),later(The second one (after the clocks go back)).
Outputs
datetext- The date on the local calendar, as YYYY-MM-DD.
date_timetext- The date and time with its UTC offset, such as 2026-10-20T05:04:01+02:00, ready for any other step's date field.
day_of_weektext- The local day of the week in English, such as Tuesday.
dst_activetrue/false- True when daylight saving (summer) time is in force then.
from_date_timetext- The date and time that was converted, as local time in that zone with its offset.
from_time_zonetext- The time zone converted from.
summarytext- One sentence with both times, for a message.
timetext- The local clock time, as HH:MM:SS on a 24-hour clock.
time_moved_forwardtrue/false- True when the time given doesn't exist in that zone (it falls in the hour skipped when the clocks go forward), so the time just after the change was used.
to_time_zonetext- The time zone converted to.
unix_timestampnumber- The same moment as a Unix timestamp, in seconds.
utc_offsettext- How far the local clock is from UTC at that moment, such as +02:00 or -04:00.
utc_offset_secondsnumber- The same offset in seconds, such as 7200.
utc_timetext- The same moment in UTC, such as 2026-10-20T03:04:01Z.
Example output
{
"date": "2021-03-14",
"date_time": "2021-03-14T09:45:00-07:00",
"day_of_week": "Sunday",
"dst_active": true,
"from_date_time": "2021-03-14T17:45:00+01:00",
"from_time_zone": "Europe/Amsterdam",
"summary": "17:45 on Sunday 14 March 2021 in Europe/Amsterdam is 09:45 on Sunday 14 March 2021 in America/Los_Angeles.",
"time": "09:45:00",
"time_moved_forward": false,
"to_time_zone": "America/Los_Angeles",
"unix_timestamp": 1615740300,
"utc_offset": "-07:00",
"utc_offset_seconds": -25200,
"utc_time": "2021-03-14T16:45:00Z"
}Get the current time at a location
Find the time zone of a place on the map from its latitude and longitude, and the date and time there right now. Out at sea the answer is the fixed zone for that longitude, such as Etc/GMT+11. No API key required.
Inputs
- Latitude
latitudenumberRequired - How far north (positive) or south (negative) of the equator, from -90 to 90. For example 51.5074 for London.From -90 to 90.
- Longitude
longitudenumberRequired - How far east (positive) or west (negative) of Greenwich, from -180 to 180. For example -0.1278 for London.From -180 to 180.
Outputs
datetext- The date on the local calendar, as YYYY-MM-DD.
date_timetext- The date and time with its UTC offset, such as 2026-10-20T05:04:01+02:00, ready for any other step's date field.
day_of_weektext- The local day of the week in English, such as Tuesday.
dst_activetrue/false- True when daylight saving (summer) time is in force then.
latitudenumber- The latitude that was looked up.
longitudenumber- The longitude that was looked up.
summarytext- One sentence with the time, the date, the zone and its offset, for a message.
timetext- The local clock time, as HH:MM:SS on a 24-hour clock.
time_zonetext- The time zone the time is given in, such as Europe/Amsterdam.
unix_timestampnumber- The same moment as a Unix timestamp, in seconds.
utc_offsettext- How far the local clock is from UTC at that moment, such as +02:00 or -04:00.
utc_offset_secondsnumber- The same offset in seconds, such as 7200.
utc_timetext- The same moment in UTC, such as 2026-10-20T03:04:01Z.
Example output
{
"date": "2026-10-19",
"date_time": "2026-10-19T23:04:01-04:00",
"day_of_week": "Monday",
"dst_active": true,
"latitude": 38.9,
"longitude": -77.03,
"summary": "It's 23:04 on Monday 19 October 2026 in America/New_York (UTC-04:00, daylight saving time).",
"time": "23:04:01",
"time_zone": "America/New_York",
"unix_timestamp": 1792465441,
"utc_offset": "-04:00",
"utc_offset_seconds": -14400,
"utc_time": "2026-10-20T03:04:01Z"
}Get the current time for an IP address
Find the time zone of a public IPv4 address, such as a website visitor's, and the date and time there right now. Useful for greeting people or scheduling in their local time. When TimeAPI can't place an address it answers with UTC. No API key required.
Inputs
- IP address
ip_addresstextRequired - A public IPv4 address, such as a website visitor's. Private addresses (10.x, 192.168.x, 127.0.0.1) have no location and are refused, and so are IPv6 addresses, which TimeAPI can't place.
Outputs
datetext- The date on the local calendar, as YYYY-MM-DD.
date_timetext- The date and time with its UTC offset, such as 2026-10-20T05:04:01+02:00, ready for any other step's date field.
day_of_weektext- The local day of the week in English, such as Tuesday.
dst_activetrue/false- True when daylight saving (summer) time is in force then.
ip_addresstext- The IP address that was looked up.
summarytext- One sentence with the time, the date, the zone and its offset, for a message.
timetext- The local clock time, as HH:MM:SS on a 24-hour clock.
time_zonetext- The time zone the time is given in, such as Europe/Amsterdam.
unix_timestampnumber- The same moment as a Unix timestamp, in seconds.
utc_offsettext- How far the local clock is from UTC at that moment, such as +02:00 or -04:00.
utc_offset_secondsnumber- The same offset in seconds, such as 7200.
utc_timetext- The same moment in UTC, such as 2026-10-20T03:04:01Z.
Example output
{
"date": "2026-10-19",
"date_time": "2026-10-19T20:04:02-07:00",
"day_of_week": "Monday",
"dst_active": true,
"ip_address": "8.8.8.8",
"summary": "It's 20:04 on Monday 19 October 2026 in America/Los_Angeles (UTC-07:00, daylight saving time).",
"time": "20:04:02",
"time_zone": "America/Los_Angeles",
"unix_timestamp": 1792465442,
"utc_offset": "-07:00",
"utc_offset_seconds": -25200,
"utc_time": "2026-10-20T03:04:02Z"
}Get the current time in a time zone
Get the date and time right now in any time zone: the local date, the clock time, the day of the week, the UTC offset, whether daylight saving time is on, and the same moment in UTC. Includes a ready-made sentence for a message. No API key required.
Inputs
- Time zone
time_zonetextRequired - The time zone, by its standard name such as Europe/London or America/New_York. Pick it from the list, which holds every zone TimeAPI knows.
Outputs
datetext- The date on the local calendar, as YYYY-MM-DD.
date_timetext- The date and time with its UTC offset, such as 2026-10-20T05:04:01+02:00, ready for any other step's date field.
day_of_weektext- The local day of the week in English, such as Tuesday.
dst_activetrue/false- True when daylight saving (summer) time is in force then.
summarytext- One sentence with the time, the date, the zone and its offset, for a message.
timetext- The local clock time, as HH:MM:SS on a 24-hour clock.
time_zonetext- The time zone the time is given in, such as Europe/Amsterdam.
unix_timestampnumber- The same moment as a Unix timestamp, in seconds.
utc_offsettext- How far the local clock is from UTC at that moment, such as +02:00 or -04:00.
utc_offset_secondsnumber- The same offset in seconds, such as 7200.
utc_timetext- The same moment in UTC, such as 2026-10-20T03:04:01Z.
Example output
{
"date": "2026-10-20",
"date_time": "2026-10-20T05:04:01+02:00",
"day_of_week": "Tuesday",
"dst_active": true,
"summary": "It's 05:04 on Tuesday 20 October 2026 in Europe/Amsterdam (UTC+02:00, daylight saving time).",
"time": "05:04:01",
"time_zone": "Europe/Amsterdam",
"unix_timestamp": 1792465441,
"utc_offset": "+02:00",
"utc_offset_seconds": 7200,
"utc_time": "2026-10-20T03:04:01Z"
}Get the current Unix time
Get the current Unix timestamp (time since 1 January 1970 in UTC) in seconds, milliseconds or microseconds, with the same moment as UTC text. Many APIs and databases want time in this form. No API key required.
Inputs
- Precision
precisiontext - Whole seconds, milliseconds or microseconds. Seconds if left empty.One of:
seconds,milliseconds,microseconds. Default:seconds.
Outputs
precisiontext- The precision of unix_timestamp: seconds, milliseconds or microseconds.
unix_secondsnumber- The same moment in whole seconds.
unix_timestampnumber- Time since 1 January 1970 (UTC) in the precision asked for: seconds, milliseconds or microseconds.
utc_timetext- The same moment as UTC text, with as many decimal places as the precision, such as 2026-10-20T03:04:00.717Z.
Example output
{
"precision": "milliseconds",
"unix_seconds": 1792465438,
"unix_timestamp": 1792465438919,
"utc_time": "2026-10-20T03:03:58.919Z"
}Get the day of the week
Find which day of the week a date falls on, its number in the week (1 for Monday to 7 for Sunday) and whether it's a weekend. No API key required.
Inputs
- Date
datedateRequired - The date to check. A date and time from an earlier step works too: its date is used as written.
Outputs
datetext- The date, as YYYY-MM-DD.
day_numbernumber- The day's number in the week, from 1 for Monday to 7 for Sunday.
day_of_weektext- The day of the week in English, such as Sunday.
is_weekendtrue/false- True for a Saturday or a Sunday.
summarytext- One sentence with the date and its day, for a message.
Example output
{
"date": "2021-03-14",
"day_number": 7,
"day_of_week": "Sunday",
"is_weekend": true,
"summary": "14 March 2021 is a Sunday."
}Get the day of the year
Find which day of its year a date is (1 to 366), how many days that year has, how many are left after it, and whether it's a leap year. No API key required.
Inputs
- Date
datedateRequired - The date to check. A date and time from an earlier step works too: its date is used as written.
Outputs
datetext- The date, as YYYY-MM-DD.
day_of_yearnumber- Which day of its year the date is, from 1 for 1 January.
days_in_yearnumber- How many days that year has: 365, or 366 in a leap year.
days_left_in_yearnumber- How many days of the year come after this one.
is_leap_yeartrue/false- True when the year has a 29 February.
summarytext- One sentence with the date and its day number, for a message.
Example output
{
"date": "2021-03-14",
"day_of_year": 73,
"days_in_year": 365,
"days_left_in_year": 292,
"is_leap_year": false,
"summary": "14 March 2021 is day 73 of 365 in 2021."
}Get time zone details
Get a time zone's details: its UTC offset now and in standard time, whether it uses daylight saving time, when that starts and ends, and its current local time. Find the zone by its name, by a latitude and longitude, or by a public IPv4 address. No API key required.
Inputs
- Look up by
look_up_bytext - How to find the time zone: by its name, by a place's latitude and longitude, or by an IP address.One of:
time_zone(Time zone name),coordinates(Latitude and longitude),ip_address(IP address). Default:time_zone. - Time zone
time_zonetext - The time zone, by its standard name such as Europe/London or America/New_York. Pick it from the list, which holds every zone TimeAPI knows.Only when Look up by is Time zone name.
- Latitude
latitudenumber - How far north (positive) or south (negative) of the equator, from -90 to 90. For example 51.5074 for London.Only when Look up by is Latitude and longitude. From -90 to 90.
- Longitude
longitudenumber - How far east (positive) or west (negative) of Greenwich, from -180 to 180. For example -0.1278 for London.Only when Look up by is Latitude and longitude. From -180 to 180.
- IP address
ip_addresstext - A public IPv4 address, such as a website visitor's. Private addresses (10.x, 192.168.x, 127.0.0.1) have no location and are refused, and so are IPv6 addresses, which TimeAPI can't place.Only when Look up by is IP address.
Outputs
day_of_weektext- The local day of the week in English.
dst_activetrue/false- True when daylight saving time is in force right now.
dst_endtext- When that daylight saving period ends, in UTC. Empty when the zone has none.
dst_shift_secondsnumber- How far the clocks move, in seconds (3600 is an hour). Empty when the zone has no daylight saving time.
dst_starttext- When the current or next daylight saving period starts, in UTC. Empty when the zone has none.
dst_utc_offsettext- The offset during daylight saving time. Empty when the zone has none.
has_dsttrue/false- True when the zone changes its clocks for daylight saving time.
local_timetext- The current local date and time with its offset.
looked_up_bytext- How it was found: time_zone, coordinates or ip_address.
standard_utc_offsettext- The zone's offset outside daylight saving time, such as +00:00.
standard_utc_offset_secondsnumber- The same standard offset in seconds.
summarytext- A sentence or two with the zone's offset, daylight saving and local time.
time_zonetext- The time zone's standard name, such as Europe/London.
unix_timestampnumber- The same moment as a Unix timestamp, in seconds.
utc_offsettext- How far the zone is from UTC right now, such as +01:00.
utc_offset_secondsnumber- The same offset in seconds.
utc_timetext- The same moment in UTC.
Example output
{
"day_of_week": "Tuesday",
"dst_active": true,
"dst_end": "2026-10-25T01:00:00Z",
"dst_shift_seconds": 3600,
"dst_start": "2026-03-29T01:00:00Z",
"dst_utc_offset": "+01:00",
"has_dst": true,
"local_time": "2026-10-20T04:14:51+01:00",
"looked_up_by": "time_zone",
"standard_utc_offset": "+00:00",
"standard_utc_offset_seconds": 0,
"summary": "Europe/London is at UTC+01:00 now, on daylight saving time (it changes clocks by 1 hour). It's 04:14 on Tuesday 20 October 2026 there.",
"time_zone": "Europe/London",
"unix_timestamp": 1792466091,
"utc_offset": "+01:00",
"utc_offset_seconds": 3600,
"utc_time": "2026-10-20T03:14:51Z"
}List time zones
List the time zones TimeAPI knows (about 600), by their standard names such as America/New_York, which is what every time zone field takes. Narrow the list to a region or to names containing some text, such as a city. No API key required.
Inputs
- Region
regiontext - Only zones in this part of the world. Leave it empty for all of them.One of:
Africa,America(The Americas),Antarctica,Arctic,Asia,Atlantic(Atlantic Ocean),Australia,Europe,Indian(Indian Ocean),Pacific(Pacific Ocean),Etc(Fixed offsets from UTC (Etc)),other(Older names and abbreviations (US/Eastern, GB, EST)). - Name contains
searchtext - Only zones whose name contains this text, in any letter case, such as a city. Spaces match the underscores in names, so new york finds America/New_York.
Outputs
countnumber- How many time zones are listed.
regiontext- The region the list was narrowed to, if any.
searchtext- The text the list was narrowed to, if any.
time_zoneslist- The time zones found, in alphabetical order.
total_availablenumber- How many time zones TimeAPI knows in all.
Example output
{
"count": 3,
"region": "Europe",
"search": "bu",
"time_zones": [
{
"location": "Bucharest",
"name": "Europe/Bucharest",
"region": "Europe"
},
{
"location": "Budapest",
"name": "Europe/Budapest",
"region": "Europe"
},
{
"location": "Busingen",
"name": "Europe/Busingen",
"region": "Europe"
}
],
"total_available": 597
}Translate a date
Write a date and time out in words in another language, the way that language writes dates: for example Sonntag, 14. März 2021 17:45:00 in German. Returns the date and time together and each on its own. 134 languages are available. No API key required.
Inputs
- Date and time
date_timedate and timeRequired - The date and time to write out. Text without a zone, such as 2026-03-15 14:00, is written exactly as given. A time picked with the picker is an exact moment, so it's written as local time in the Time zone.
- Language
languagetextRequired - The language to write the date in.One of:
af(Afrikaans (af)),ak(Akan (ak)),sq(Albanian (sq)),am(Amharic (am)),ar(Arabic (ar)),hy(Armenian (hy)),as(Assamese (as)),az(Azerbaijani (az)),bm(Bambara (bm)),eu(Basque (eu)), and 124 more. - Time zone
time_zonetext - The time zone to write a picked time in. Pick your own to have it written as you picked it. UTC if left empty. Not used for text without a zone. The time zone, by its standard name such as Europe/London or America/New_York. Pick it from the list, which holds every zone TimeAPI knows.
Outputs
date_texttext- Only the date written out, such as Sonntag, 14. März 2021.
date_timetext- The local date and time that was written out, as YYYY-MM-DDTHH:MM:SS.
languagetext- The language's two-letter code, such as de.
language_nametext- The language's name in English, such as German.
texttext- The date and time written out in that language, such as Sonntag, 14. März 2021 17:45:00.
time_texttext- Only the time, as that language writes it.
time_zonetext- The time zone it was written in. Empty when the date and time was text with no zone, which is written as given.
Example output
{
"date_text": "Sonntag, 14. M\u00e4rz 2021",
"date_time": "2021-03-14T17:45:00",
"language": "de",
"language_name": "German",
"text": "Sonntag, 14. M\u00e4rz 2021 17:45:00",
"time_text": "17:45:00",
"time_zone": "Europe/Berlin"
}