Holiday Sale! Get over 30% off when you subscribe to an annual plan!

World Time API

The World Time API provides the current date and time for any city, latitude/longitude coordinates or timezone in the world.

(4.2)

From 7,436 users

1,700+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
344ms380ms414ms629ms1198ms

Didn't find what you were looking for? Suggest an improvement

/v1/worldtime GET

https://api.api-ninjas.com/v1/worldtime

Get the current date and time by city/state/country, location coordinates (latitude/longitude), or timezone.

Parameters

One of the following parameter combinations must be provided:

  • timezone
  • lat and lon
  • city (optionally with state and/or country)
  • timezone  optional

    Timezone name (e.g. Europe/London).

  • lat  optional premium

    Latitude of desired location.

  • lon  optional premium

    Longitude of desired location.

  • city  optional premium

    City name.

  • state  optional premium

    US state (for United States cities only).

  • country  optional premium

    Country name.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

  • timezone

    IANA timezone identifier (for example Europe/London).

  • datetime

    Local date and time string (YYYY-MM-DD HH:MM:SS).

  • date

    Current date in YYYY-MM-DD format.

  • year

    Current year as a 4-digit string.

  • month

    Current month as a 2-digit string between 01 and 12 (inclusive).

  • day

    Current day of the month as a 2-digit string between 01 and 31 (inclusive).

  • hour

    Current hour in 24-hour format as a 2-digit string between 00 and 23 (inclusive).

  • minute

    Current minute as a 2-digit string between 00 and 59 (inclusive).

  • second

    Current second as a 2-digit string between 00 and 59 (inclusive).

  • day_of_week

    Name of the day of the week (for example Sunday).

Sample Request Live Demo!

city premium
state premium
country premium
lat
lon

Try this API endpoint with all available parameters in our API playground

https://api.api-ninjas.com/v1/worldtime?city=London

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
1 2 3 4 5 6 7 8 9 10 11 12 { "timezone": "Europe/London", "datetime": "2022-09-18 19:16:43", "date": "2022-09-18", "year": "2022", "month": "09", "day": "18", "hour": "19", "minute": "16", "second": "43", "day_of_week": "Sunday" }

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/worldtime?city=london" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.