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

ActionWhat it does
Add or subtract timeAdd 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 zoneConvert 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 locationFind 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 addressFind 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 zoneGet 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 timeGet 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 weekFind 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 yearFind 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 detailsGet 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 zonesList 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 dateWrite 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 subtractoperationtext
Whether to go forward in time (add) or back (subtract). Add if left empty.One of: add, subtract. Default: add.
Daysdaysnumber
How many days. Decimals are fine: 0.5 is 12 hours.From 0 to 36525.
Hourshoursnumber
How many hours, any number: 36 is a day and a half.From 0 to 876600.
Minutesminutesnumber
How many minutes, any number: 90 is an hour and a half.From 0 to 52596000.
Secondssecondsnumber
How many seconds, any number, with decimals for parts of a second.From 0 to 3155760000.
Time zonetime_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 fromdate_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 twiceif_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 timedate_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 zonefrom_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 zoneto_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 twiceif_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

LatitudelatitudenumberRequired
How far north (positive) or south (negative) of the equator, from -90 to 90. For example 51.5074 for London.From -90 to 90.
LongitudelongitudenumberRequired
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 addressip_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 zonetime_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

Precisionprecisiontext
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

DatedatedateRequired
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

DatedatedateRequired
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 bylook_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 zonetime_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.
Latitudelatitudenumber
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.
Longitudelongitudenumber
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 addressip_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

Regionregiontext
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 containssearchtext
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 timedate_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.
LanguagelanguagetextRequired
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 zonetime_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"
}

On this page