← Back to docs
endpoints
POST locci/geo/city/world-clock/

Current date and time for all world-clock cities, ordered by UTC offset.

Locci Geography

Overview

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.


Request parameters

This endpoint does not require any request parameters.


Response fields

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