from
query Required string
Time specifier. Supported forms are `now`, `unix=<seconds>`, `unix_ms=<milliseconds>`, `iso=<ISO-8601>`, `offset=±HH:MM`, `tz=<IANA timezone>`, and `ip=<IP address>`. For `tz=...`, `ip=...`, and `offset=...`, the specifier means the current request-time instant resolved through that selector. To express a local wall-clock time, use `from=iso=...` together with one of `from_tz`, `from_ip`, `from_lat`+`from_lon`, or `from_offset`.
Time specifier. Supported forms are `now`, `unix=<seconds>`, `unix_ms=<milliseconds>`, `iso=<ISO-8601>`, `offset=±HH:MM`, `tz=<IANA timezone>`, and `ip=<IP address>`. For `tz=...`, `ip=...`, and `offset=...`, the specifier means the current request-time instant resolved through that selector. To express a local wall-clock time, use `to=iso=...` together with one of `to_tz`, `to_ip`, `to_lat`+`to_lon`, or `to_offset`.
from_tz
query Optional string
Used only with `from=iso=...` when the ISO value has no explicit offset.
from_ip
query Optional string
Used only with `from=iso=...` when the ISO value has no explicit offset. Resolves that local wall-clock time through the timezone mapped from this IP address.
Used only with `from=iso=...` when the ISO value has no explicit offset. Provide together with `from_lon` to resolve that local wall-clock time through the timezone mapped from these coordinates.
Used only with `from=iso=...` when the ISO value has no explicit offset. Provide together with `from_lat`.
from_offset
query Optional string
Used only with `from=iso=...` when the ISO value has no explicit offset. Interprets that local wall-clock time at this fixed UTC offset.
to_tz
query Optional string
Used only with `to=iso=...` when the ISO value has no explicit offset.
to_ip
query Optional string
Used only with `to=iso=...` when the ISO value has no explicit offset. Resolves that local wall-clock time through the timezone mapped from this IP address.
Used only with `to=iso=...` when the ISO value has no explicit offset. Provide together with `to_lon` to resolve that local wall-clock time through the timezone mapped from these coordinates.
Used only with `to=iso=...` when the ISO value has no explicit offset. Provide together with `to_lat`.
to_offset
query Optional string
Used only with `to=iso=...` when the ISO value has no explicit offset. Interprets that local wall-clock time at this fixed UTC offset.
format
query Optional string
Custom duration format template using `%days`, `%hours`, `%minutes`, and `%seconds`.
business_days
query Optional boolean
Set to `true` to enable weekday/business-day counting.
holiday_country
query Optional string
ISO 3166-1 alpha-2 holiday calendar country code. Requires `business_days=true`.
holiday_subdivision
query Optional string
Holiday calendar subdivision code from the upstream `python-holidays` calendar, for example `CA` or `ENG`. Requires `holiday_country` and `business_days=true`.
sign
query Optional boolean
Set to `true` to ask the gateway to sign the final JSON response. Not supported on `/v1/time/clock`.