Skip to content
HALOWERK

Codewerk

cron explain

Validates the expression with cron-parser 5.10.3 (5 fields, or 6 with seconds first; names, ranges, steps, L and # supported; macros @yearly . @hourly). The explanation is generated from the fields, including the standard cron rule that day-of-month and day-of-week are OR-combined when both are restricted. Next runs are computed in the requested IANA zone (luxon 3.7.2, tz database of the Node.js ICU). For every DST transition within the horizon the service checks whether scheduled.

POST https://code.halowerk.com/v1/cron-explain

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
expressionstringYesCron expression, e.g. "30 2 * * 1-5" or "@daily".
timezonestringNoIANA time zone, e.g. Europe/Berlin.
startstringNoCompute runs after this instant (default: now).
countintegerNo
horizon_daysintegerNoDays after start to scan for DST transitions.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "expression"
  ],
  "properties": {
    "expression": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Cron expression, e.g. \"30 2 * * 1-5\" or \"@daily\"."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "default": "UTC",
      "description": "IANA time zone, e.g. Europe/Berlin."
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "Compute runs after this instant (default: now)."
    },
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 5
    },
    "horizon_days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 400,
      "default": 366,
      "description": "Days after start to scan for DST transitions."
    }
  }
}

Open original schema

Published input example

{
  "expression": "30 2 * * *",
  "timezone": "Europe/Berlin",
  "start": "2026-03-28T12:00:00+01:00",
  "count": 3
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’