{"uid":"cap_e0uoIo-eQ72NYEyAZMJ-W","slug":"date-math-icalendar-rrule-recurrence-expander-ae7a43c4","name":"Date Math – iCalendar RRULE Recurrence Expander","description":"Date Math: Expand a recurring event or iCalendar RRULE (\"every 2nd Tuesday\", \"Mon/Wed until June\") into concrete dates and times in a time zone, DST-aware, with optional excluded dates. Use for repeating meetings, calendar invites and schedules.","url":"https://date-math.datemath.workers.dev/v1/recurrence?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"count":{"type":"integer","maximum":200,"minimum":1,"description":"Default 10"},"rrule":{"type":"string","example":"FREQ=MONTHLY;BYDAY=2TU","description":"iCalendar RRULE (no DTSTART/TZID inside)"},"start":{"type":"string","description":"Local start date or datetime in timezone, e.g. 2026-01-01T10:00"},"exclude":{"type":"array","items":{"type":"string"},"description":"Local dates (YYYY-MM-DD) to skip"},"timezone":{"type":"string","description":"Default UTC"}}},"responseSchema":{"type":"json","example":{"count":3,"rrule":"FREQ=MONTHLY;BYDAY=2TU","start":"2026-01-01T10:00","timezone":"Asia/Manila","description":"every month on the 2nd Tuesday","occurrences":[{"utc":"2026-01-13T02:00:00Z","date":"2026-01-13","local":"2026-01-13T10:00:00+08:00","weekday":"Tuesday"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ihQUqd_XKmPMEek_sSvs-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Expands an iCalendar RRULE string into a list of concrete, timezone-aware occurrence dates and times, with DST handling and optional excluded dates.","exampleAgentPrompt":"Expand the RRULE 'FREQ=MONTHLY;BYDAY=2TU' starting from 2026-01-01T10:00 in the Asia/Manila timezone and give me the next 5 occurrences, excluding 2026-03-10.","exampleUseCases":[{"title":"Weekly team standup schedule","prompt":"My team has a standup every Monday, Wednesday, and Friday at 9am Eastern starting January 5, 2026 — can you list the next 20 occurrences using the RRULE 'FREQ=WEEKLY;BYDAY=MO,WE,FR', and skip the holiday on 2026-01-19?"},{"title":"Monthly billing reminder dates","prompt":"Our billing runs on the last day of every month starting 2026-01-31 at 8am UTC. Use RRULE 'FREQ=MONTHLY;BYMONTHDAY=-1' and show me all 12 occurrences for the year."},{"title":"Recurring event until a deadline","prompt":"I have an event every other Thursday starting 2026-02-05T14:00 in Europe/London that ends in June 2026 — the RRULE is 'FREQ=WEEKLY;INTERVAL=2;BYDAY=TH;UNTIL=20260630'. Can you list all the dates for me?"}],"resultDescription":"Returns a JSON object with the RRULE string, start, timezone, a human-readable description of the recurrence pattern, and an array of occurrences each containing UTC ISO 8601 datetime, local datetime with offset, date string (YYYY-MM-DD), and weekday name. Also echoes back the count requested.","failureModes":["Invalid or malformed RRULE string returns an error","Unsupported timezone identifier causes rejection","Count exceeds maximum of 200 results in validation error","Excluded date format not in YYYY-MM-DD causes parsing failure","Start date/time not parseable in the given timezone returns error","Missing required fields (rrule, start) return 400-level errors"],"whenToPreferThis":"Use this endpoint when you need to materialize a recurring schedule from an iCalendar RRULE into actual concrete dates — especially when DST-aware local times matter, you need to skip specific excluded dates, or you need a human-readable English description of the recurrence pattern alongside the dates. Prefer it over cron-based tools when the input is iCal-format recurrence rules (e.g. from calendar apps or CalDAV systems).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:36:09.659Z","isFirstParty":false,"canonicalSlug":"date-math-icalendar-rrule-recurrence-expander-ae7a43c4"}