Skip to content
HALOWERK

Datenwerk

rrule expand

The rule is validated part by part and expanded with rrule.js on wall-clock time; every occurrence is then placed in the IANA zone with luxon, so 10:00 stays 10:00 across daylight-saving changes (non-existent and ambiguous times follow RFC 5545 3.3.5). A UTC UNTIL is converted to local time first. EXDATE (date or date-time) and RDATE are applied. Public holidays come from date-holidays 3.38 (data CC BY-SA 3.0, type public) for a country and optional state/region; such occurrences are skipped.

POST https://daten.halowerk.com/v1/rrule-expand

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
rrulestringYesRRULE value, e.g. FREQ=WEEKLY;BYDAY=MO,WE;COUNT=10 (prefix RRULE: allowed).
dtstartstringYesFirst occurrence as local date-time in timezone, e.g. 2026-11-02T09:30.
timezonestringYesIANA zone of dtstart.
duration_minutesintegerNoOptional length of each occurrence.
exdatesarrayNoExcluded dates (whole day) or local date-times.
rdatesarrayNoAdditional local date-times.
range_startstringNoOnly return occurrences on or after this local date.
range_endstringNoOnly return occurrences on or before this local date.
holidaysobjectNoPublic holidays to respect (date-holidays data, type "public" only).
business_days_onlybooleanNoAlso treat Saturdays and Sundays as non-business days.
holiday_actionstringNo
max_occurrencesintegerNo
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "rrule",
    "dtstart",
    "timezone"
  ],
  "properties": {
    "rrule": {
      "type": "string",
      "minLength": 6,
      "maxLength": 500,
      "description": "RRULE value, e.g. FREQ=WEEKLY;BYDAY=MO,WE;COUNT=10 (prefix RRULE: allowed)."
    },
    "dtstart": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$",
      "description": "First occurrence as local date-time in timezone, e.g. 2026-11-02T09:30."
    },
    "timezone": {
      "type": "string",
      "maxLength": 64,
      "description": "IANA zone of dtstart."
    },
    "duration_minutes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10080,
      "description": "Optional length of each occurrence."
    },
    "exdates": {
      "type": "array",
      "maxItems": 500,
      "items": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}(T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?)?$"
      },
      "description": "Excluded dates (whole day) or local date-times."
    },
    "rdates": {
      "type": "array",
      "maxItems": 500,
      "items": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}T([01]\\d|2[0-3]):[0-5]\\d(:[0-5]\\d)?$"
      },
      "description": "Additional local date-times."
    },
    "range_start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only return occurrences on or after this local date."
    },
    "range_end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Only return occurrences on or before this local date."
    },
    "holidays": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "country"
      ],
      "description": "Public holidays to respect (date-holidays data, type \"public\" only).",
      "properties": {
        "country": {
          "type": "string",
          "pattern": "^[A-Za-z]{2}$",
          "description": "ISO 3166-1 alpha-2 country code, e.g. DE."
        },
        "state": {
          "type": "string",
          "maxLength": 6,
          "description": "Optional state/subdivision code, e.g. NW or BY."
        },
        "region": {
          "type": "string",
          "maxLength": 10,
          "description": "Optional region code below the state, e.g. A (Augsburg)."
        }
      }
    },
    "business_days_only": {
      "type": "boolean",
      "default": false,
      "description": "Also treat Saturdays and Sundays as non-business days."
    },
    "holiday_action": {
      "type": "string",
      "enum": [
        "skip",
        "next_business_day",
        "previous_business_day"
      ],
      "default": "skip"
    },
    "max_occurrences": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "default": 200
    }
  }
}

Open original schema

Published input example

{
  "rrule": "FREQ=WEEKLY;BYDAY=FR;COUNT=4",
  "dtstart": "2026-03-27T10:00",
  "timezone": "Europe/Berlin",
  "holidays": {
    "country": "DE"
  }
}

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 โ†’