locci/geo/city/world-clock/
Returns the current live date and time for a curated set of representative world cities, one per timezone, ordered by UTC offset from west to east. Each entry includes the city name, current time in multiple formats (12-hour, 24-hour, short), GMT and DST offsets, the timezone abbreviation, and the country's emoji flag. Designed to power a world clock display showing what time it is right now in cities around the globe.
This endpoint does not require any request parameters.
| Name | Type | Nullable | Description | Example |
|---|---|---|---|---|
results |
Array | — | Array of world-clock cities ordered by ascending UTC offset (westernmost to easternmost). | |
results[].city_id |
Integer | — | Primary key of the city. | 5969782 |
results[].city_name |
String | — | Name of the city. | Victoria |
results[].city_slug |
String | — | URL-friendly city name. | victoria |
results[].country_flag |
String | — | Emoji flag for the country (e.g. 🇨🇦). | 🇨🇦 |
results[].country_name |
String | — | Full name of the country the city belongs to. | Canada |
results[].current_date |
String | — | Current date formatted as abbreviated weekday and month (e.g. Sat Jun 21 2025). | Sat Jun 21 2025 |
results[].current_datetime |
Datetime | — | Full current datetime in the city's local timezone. | 2025-06-21T14:32:00-07:00 |
results[].current_day |
String | — | Current two-digit day of the month (01–31). | 21 |
results[].current_hours |
String | — | Current hour in 24-hour format (00–23). | 14 |
results[].current_minutes |
String | — | Current minutes (00–59). | 32 |
results[].current_month |
String | — | Current two-digit month (01–12). | 06 |
results[].current_seconds |
String | — | Current seconds (00–59). | 45 |
results[].current_short_date |
String | — | Current date as ISO 8601 (YYYY-MM-DD). | 2025-06-21 |
results[].current_time |
String | — | Current time as 12-hour clock with seconds and AM/PM. | 02:32:45 PM |
results[].current_time_short |
String | — | Current time as 12-hour clock without seconds (e.g. 02:32 pm). | 02:32 pm |
results[].current_weekday_short_name |
String | — | Abbreviated weekday name (e.g. Sat). | Sat |
results[].current_year |
String | — | Current four-digit year. | 2025 |
results[].timezone_code |
String | — | Abbreviated timezone code at the current moment (e.g. PST or PDT). | PDT |
results[].timezone_dst_offset |
String | — | DST offset string prefixed with DST (e.g. DST-06:00). | DST-06:00 |
results[].timezone_formatted |
String | — | Timezone name with underscores replaced by spaces. | America/Vancouver |
results[].timezone_gmt_offset |
String | — | UTC offset string prefixed with GMT (e.g. GMT-07:00). | GMT-07:00 |
results[].timezone_name |
String | — | IANA timezone name for the city. | America/Vancouver |
results[].timezone_slug |
String | — | URL-friendly timezone name. | america-vancouver |