{"uid":"cap_Qolq0I1uikByRsQffnPDr","slug":"date-math-cron-expression-explainer-ee6c98e2","name":"Date Math Cron Expression Explainer","description":"Date Math: Explain a cron expression in plain English and list its next run times in any time zone. Use to check or debug crontab and scheduled-job schedules.","url":"https://date-math.datemath.workers.dev/v1/cron?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"from":{"type":"string","description":"ISO 8601 datetime with offset; default now"},"count":{"type":"integer","maximum":100,"minimum":1,"description":"Default 5"},"timezone":{"type":"string","description":"Default UTC"},"expression":{"type":"string","example":"0 9 * * 1-5","description":"5- or 6-field cron expression"}}},"responseSchema":{"type":"json","example":{"from":"2026-11-10T13:23:34.584Z","timezone":"Asia/Manila","next_runs":[{"utc":"2026-11-11T01:00:00Z","local":"2026-11-11T09:00:00+08:00","weekday":"Wednesday"}],"expression":"0 9 * * 1-5","description":"At 09:00, Monday through Friday"}},"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_gLkcARINREJGMT26euqBA","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":"Translates a cron expression into a plain-English description and lists its next N scheduled run times in any IANA time zone.","exampleAgentPrompt":"What does the cron expression '0 9 * * 1-5' mean in plain English, and show me the next 5 times it'll fire in the America/New_York timezone starting from now?","exampleUseCases":[{"title":"Debug a misconfigured CI/CD schedule","prompt":"I set up a cron job with expression '0 0 * * 0' to run weekly — can you explain what that means and show me the next 5 run times in UTC so I can confirm it's correct?"},{"title":"Preview a production job schedule before deploy","prompt":"Before I deploy, can you tell me what '30 6 1 * *' means in plain English and list the next 3 times it would trigger in the Europe/London timezone?"},{"title":"Explain a third-party cron schedule to a non-technical stakeholder","prompt":"Our vendor says their data export runs on '0 2 * * 1,3,5' — what does that mean in plain English and when are the next 10 occurrences in Asia/Manila time?"}],"resultDescription":"Returns the original cron expression, a plain-English description (e.g. 'At 09:00, Monday through Friday'), a from-timestamp, the requested timezone, and an array of next run objects each containing a UTC ISO 8601 timestamp, a local ISO 8601 timestamp with offset, and the weekday name.","failureModes":["Invalid cron expression returns an error — 6-field vs 5-field mismatches may be rejected","Unknown or misspelled IANA timezone string causes a validation error","Count outside the 1–100 range is rejected","Malformed ISO 8601 'from' datetime returns a parse error","Network or worker timeout for edge-deployed function (rare)"],"whenToPreferThis":"Choose this endpoint when you need to both humanize a cron expression and preview its upcoming fire times — especially useful for debugging, documentation, or presenting schedules to non-technical users. It is superior to generic date-math utilities because it handles both explanation and time-zone-aware scheduling preview in a single call, supporting 5- and 6-field cron syntax.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:37:04.674Z","isFirstParty":false,"canonicalSlug":"date-math-cron-expression-explainer-ee6c98e2"}