Misc

Query World Time

0calls

Free

Need to schedule a meeting with someone overseas and wonder what time it is there? Use this endpoint for an instant answer.

GET

uapis.cn

/api/v1/misc/worldtime

Query parameters

city

string

required

City or area to look up. Pick a standard IANA time-zone name from the , e.g. `Asia/Shanghai`, `Asia/Tokyo`, `America/New_York`.

Overview

Given a standard time-zone name (e.g. Asia/Shanghai or Europe/London), the endpoint returns the current local time, UTC offset, weekday, and other details for that zone.

Query parameters

city

stringrequired

City or area to look up. Pick a standard IANA time-zone name from the , e.g. `Asia/Shanghai`, `Asia/Tokyo`, `America/New_York`.

Name	Type	Attributes	Description
`city`	string	required	City or area to look up. Pick a standard IANA time-zone name from the , e.g. `Asia/Shanghai`, `Asia/Tokyo`, `America/New_York`.

Response

200 / OK

Lookup succeeded. Returns detailed time information for the requested time zone.

JSON

{
  "datetime": "2023-10-27T15:30:00.123456+08:00",
  "offset_seconds": 28800,
  "offset_string": "+08:00",
  "query": "Shanghai",
  "timestamp_unix": 1698391800,
  "timezone": "Asia/Shanghai",
  "weekday": "Friday"
}

400 / Bad Request

Invalid request. Please verify that the city parameter was provided.

JSON

{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Missing 'city' parameter."
}

404 / Not Found

Time zone not found. The provided name does not match a supported time zone. Verify the spelling, or use the standard Continent/City form.

JSON

{
  "code": "NOT_FOUND",
  "details": {},
  "message": "The specified timezone was not found."
}

Quick start

Pick your language to see usage examples

Auth mode:

cURL command

curl 'https://uapis.cn/api/v1/misc/worldtime?city=Asia/Shanghai'

Frequently asked questions

Are there any special restrictions for the Query World Time API?

Query World Time follows our standard usage policy. Refer to the endpoint reference above for the exact rate limits and parameter requirements. Reach out if you have unusual needs.

Are the APIs on UAPI free to use?

UAPI gives every visitor free credits so you can call any endpoint right away. Visitor credits have a usage cap, and if you need more you can for additional credits.

Do I need to register an account to use UAPI?

No registration is required for visitor credit calls. If you need more credits or want to manage your call history, you can register a free account. Signed-in users get more free credits and can review usage details in the console.

Which languages and use cases does UAPI support?

Our APIs follow standard HTTP and RESTful design, so any language that can send network requests works — including JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C#, and more. They fit web apps, mobile backends, mini-program cloud functions, automation scripts, and similar scenarios.

Related APIs

Query Weather

Checking the weather before heading out is always a good habit. This endpoint provides accurate, real-time weather data for both domestic and international cities.

Timestamp Conversion

Timestamp or date string, which is more convenient? Don't worry, this endpoint gives you both formats easily!

Convert Timestamp (legacy — use /convert/unixtime instead)

Legacy endpoint that converts a Unix timestamp into a human-readable date and time.

Calculate Date Difference

Need to know how long is between two dates? This endpoint computes the precise difference.

PreviousQuery Weather

NextQuery Lunar Calendar Time