Returns an embeddable HTML clock fragment. Input timestamp forms: - `unix=1711300000` - `unix_ms=1711300000000` - `iso=2026-04-16T09:00:00Z` - `iso=2026-04-16T09:00:00&source_tz=America/New_York` - `iso=2026-04-16T09:00:00&source_ip=8.8.8.8` - `iso=2026-04-16T09:00:00&source_lat=40.7128&source_lon=-74.0060` - `iso=2026-04-16T09:00:00&source_offset=-05:00` Target selector forms: - `tz=America/New_York` - `ip=8.8.8.8` - `lat=40.7128&lon=-74.0060` - `offset=-04:00` Incompatible combinations: - `style` is required and must be one of the 30 names in the `style` enum - at most one input timestamp form - at most one target selector family - use at most one of `source_tz`, `source_ip`, `source_lat`/`source_lon`, or `source_offset` - local-ISO companion selectors are valid only with `iso=...` that has no explicit offset - this route is single-target only; comma-separated `tz`, `ip`, and `offset` values are rejected - `sign` is not supported on this route Examples: - Digital: `/v1/time/clock?style=digital-dashboard&iso=2026-04-16T09:00:00&source_tz=America/New_York&tz=Europe/London` - Analog: `/v1/time/clock?style=analog-station&offset=-04:00`
MethodGET
Path/v1/time/clock
Parameters11
When to use it
Use the clock route when you want embeddable HTML output instead of building and styling a live clock component yourself.
It is best for dashboards, signage, status pages, or lightweight product embeds.
Request shape
Pass a required style plus one supported target selector family.
This route returns HTML, so the page documents it differently from JSON endpoints.
Selector rules
Bulk selectors are not supported on the clock route.
Signing is not supported because the route returns embeddable HTML, not JSON.
Parameters
style
queryRequiredstring
Clock style name. Valid values are enumerated here; there is no separate style discovery endpoint.
UNIX seconds timestamp. Constrained to the JavaScript `Date` safe range.
unix_ms
queryOptionalinteger:int64
UNIX milliseconds timestamp. Constrained to the JavaScript `Date` safe range.
iso
queryOptionalstring
ISO-8601 timestamp. To supply a local wall-clock time without an explicit offset, pair it with one of `source_tz=Area/City`, `source_ip=...`, `source_lat=...&source_lon=...`, or `source_offset=±HH:MM`.
source_tz
queryOptionalstring
Used only with `iso=...` when the ISO value has no explicit offset.
tz
queryOptionalstring
IANA timezone name. On bulk-capable routes, a comma-separated list enables bulk mode.
ip
queryOptionalstring
IP address. On bulk-capable routes, a comma-separated list enables bulk mode.
lat
queryOptionalnumber:double
Latitude. Must be provided together with `lon`.
lon
queryOptionalnumber:double
Longitude. Must be provided together with `lat`.
offset
queryOptionalstring
Fixed UTC offset in `+HH:MM` or `-HH:MM` format. On bulk-capable routes, a comma-separated list enables bulk mode.
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program {
static async Task Main() {
using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://timelogic-api-world-time-timezones-time-calculations.p.rapidapi.com/v1/time/clock?style=digital-dashboard&tz=America%2FNew_York&format=%25H%3A%25M%3A%25S");
request.Headers.Add("X-RapidAPI-Key", Environment.GetEnvironmentVariable("TIMELOGIC_API_KEY"));
request.Headers.Add("X-RapidAPI-Host", "timelogic-api-world-time-timezones-time-calculations.p.rapidapi.com");
using var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}
}