CRONEXPR(1)

📦 version 0.2.45, in ubuntu stonking

💖 NAME 💖

cronexpr — bestie, this is the little guy that evaluates cron expressions and prints the next scheduled times, so you never have to sit there doing mental math about when your job is actually gonna fire. 🕐✨

🎀 SYNOPSIS 🎀

cronexpr [OPTIONS] "CRON EXPRESSION"

🌸 DESCRIPTION 🌸

Okay so picture this: cronexpr takes a cron expression, parses it, and then tells you the next time (or times, bestie, plural is allowed 💅) that thing would fire. It does this relative to a given reference time — and if you don't hand it one, it just uses now. Literally so easy.

Heads up on the quoting!! CRON EXPRESSION must be quoted, or your shell is gonna word-split it into a million little pieces and everything will be chaos. 😭 Don't do that to yourself.

It's got range, too — it supports both:

  • 5-field expressions — that's minute hour day month weekday
  • 6-field expressions — same vibe but with seconds too ⏱️

...aaaand the classic shorthand glow-ups, which are:

  • @yearly
  • @monthly
  • @weekly
  • @daily
  • @hourly

Iconic behavior honestly. 👑

✨ OPTIONS ✨

  • -t TIME — this is your reference time, the moment the expression gets evaluated against. TIME is a whole or partial RFC 3339 value (like 2006-01-02T15:04:05Z07:00). If you just... don't pass it, it defaults to the current local time. No pressure. 🫶
  • -n COUNT — how many next scheduled times you want it to spit out. Default: 1 — so if you want the whole future, say so, bestie.
  • -l LAYOUT — a Go time layout string used to format each output time. For the reference on how that format even works, go look at the time package constants in the Go standard library. Default: Mon, 02 Jan 2006 15:04:05 MST ✨

🦋 OUTPUT 🦋

  • One time value per line, bestie. One. Per. Line.
  • They come out in chronological ascending order, so no scrambling around trying to sort them yourself.
  • Lines that start with # are comments — so if you're only here for the actual time values, you can just ignore them. They're not for you, they're for the vibe. 🙈

🌈 EXAMPLES 🌈

Print the next time */15 * * * * will fire:

cronexpr "*/15 * * * *"

Print the next 5 occurrences of a daily job starting from a fixed time:

cronexpr -n 5 -t 2024-01-01 "0 9 * * 1-5"

👑 SEE ALSO 👑

💀 BUGS 💀

Not me asking you to please report bugs at <https://github.com/aptible/supercronic/issues> 🐛 — like, fr fr, if something's broken, tell the maintainers, they wanna know.

k that's the whole page bestie, you're a cron girlie now 💅

This was supercronic 0.2.45, dated 2026-05-21 — like and subscribe, mwah 🎀💖

📦 where this page comes from