World Time API

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

/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

  • lat  required

    Latitude of desired location.

  • lon  required

    Longitude of desired location.

— or —
  • city  required premium

    City name.

  • state  optional premium

    US state name or 2-letter abbreviation (for United States cities only).

  • country  optional premium

    Country name or 2-letter country code.

— or —
  • timezone  required

    Timezone of desired location (e.g. Europe/London).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Sample Request

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

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 3 4 5 6 7 8 import requests city = 'london' api_url = 'https://api.api-ninjas.com/v1/worldtime?city={}'.format(city) response = requests.get(api_url, headers={'X-Api-Key': 'YOUR_API_KEY'}) if response.status_code == requests.codes.ok: print(response.text) else: print("Error:", response.status_code, response.text)

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.