Skip to content
Category

Work with timezones and local business-hour checks.

Time endpoints give you a small timezone utility layer without pulling a full scheduling platform into your application.

Routes

3 GET

Default zone

Africa/Luanda

Business window

08:00 to 17:00

Routes in this family

RoutePurposeKey query
/api/v1/time/nowReturn the current time for a timezone.timezone
/api/v1/time/convertConvert a datetime from one timezone to another.datetime, from, to
/api/v1/time/business-hoursCheck whether a datetime falls inside business hours.datetime, timezone, start, end

GET /api/v1/time/now

Use now when you need the current local time for a specific IANA timezone.

ParameterRequiredDescription
timezoneNoIANA timezone. Defaults to `Africa/Luanda`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/time/now?timezone=Africa/Luanda"
JSON200 response
{  "iso": "2026-03-23T18:45:00",  "timezone": "Africa/Luanda",  "offset": "GMT+1",  "components": {    "year": 2026,    "month": 3,    "day": 23,    "hour": 18,    "minute": 45,    "second": 0,    "weekday": 1  }}
JSONError response
{  "error": {    "code": "INVALID_TIMEZONE",    "message": "The supplied timezone is not supported by the runtime.",    "field": "timezone",    "value": "Mars/Base"  }}

GET /api/v1/time/convert

Use convert to transform a local or absolute datetime from one timezone into another.

ParameterRequiredDescription
datetimeYesISO datetime. If no offset is provided, the route interprets it in the source timezone.
fromYesSource IANA timezone.
toYesTarget IANA timezone.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/time/convert?datetime=2026-03-23T10:00:00&from=Africa/Luanda&to=UTC"
JSON200 response
{  "input": {    "datetime": "2026-03-23T10:00:00",    "timezone": "Africa/Luanda"  },  "source": {    "iso": "2026-03-23T10:00:00",    "timezone": "Africa/Luanda"  },  "target": {    "iso": "2026-03-23T09:00:00",    "timezone": "UTC"  }}
JSONError response
{  "error": {    "code": "INVALID_DATETIME",    "message": "Date-times without an offset must use YYYY-MM-DDTHH:mm or YYYY-MM-DDTHH:mm:ss format.",    "field": "datetime",    "value": "23/03/2026 10:00"  }}

GET /api/v1/time/business-hours

Use business-hours before sending notifications, calls, or reminders that should respect a local office window.

ParameterRequiredDescription
datetimeYesISO datetime to evaluate.
timezoneNoIANA timezone. Defaults to `Africa/Luanda`.
startNoBusiness-day start time in `HH:mm`. Defaults to `08:00`.
endNoBusiness-day end time in `HH:mm`. Defaults to `17:00`.
GNU BashcURL usage
curl -s "https://utils.api.orb3x.com/api/v1/time/business-hours?datetime=2026-03-23T09:30:00&timezone=Africa/Luanda"
JSON200 response
{  "timezone": "Africa/Luanda",  "businessHours": {    "start": "08:00",    "end": "17:00",    "timezone": "Africa/Luanda"  },  "isBusinessDay": true,  "isWithinBusinessHours": true}
JSONError response
{  "error": {    "code": "INVALID_TIME",    "message": "The \"start\" query parameter must use HH:mm format.",    "field": "start",    "value": "8am"  }}