Change Log

All notable changes to this project will be documented in this file. This change log follows the conventions of keepachangelog.com.

Unreleased

Nothing here yet.

v0.2.62 - 2026-05-04

Added

• cron->dt to support an options map with :start and :tz keys with a zoned datetime to start the sequence from and a timezone for the output zoned datetimes respectively (34, 35)

• Time specification "nicknames" support, e.g. @yearly, @monthly, @daily, etc. (32)

• Explicit testing for GraalVM native-image compilation (38)

• More natural English descriptions for common date and time patterns in cron->text, e.g. 0 9 * * 1-5 produces every weekday at 9:00 rather than at minute 0, past hour 9, on every day of week from Monday through Friday, in every month (40)

• Support locales for cron->text. Predefined locales: English (default), German, Russian, Spanish, Portuguese (42)

v0.2.45 - 2025-12-16

Added

• Documentation for contributors and release managers

Changed

• CI pipeline dependencies bumped
• Makefile to run the CI pipeline locally

v0.2.26 - 2023-09-24

Changed

• Clojure removed from package dependencies

v0.2.22 - 2023-09-03

Fixed

• Base exception handling for cron-validate function (#9)

v0.2.20 - 2023-09-02

Changed

• cron->dt, cron->text return nil if a given crontab string cannot be parsed (#7)

Added

• cron-validate function takes in a crontab string and returns a map of {:ok? <bool> :error <nilable-str>} explaining parsing errors
• cron-valid? function takes in a crontab string and returns a boolean value to show if parsing was successful

v0.2.16 - 2023-08-11

NB! Release breaks backward compatibility. See release notes.

Added

• Parse a crontab entry into a human-readable English text with cron->text function (#3)
• Parse a crontab entry into a lazy sequence of java.time.ZonedDateTime objects with cron->dt function (used instead of get-dt-seq, year range function arguments dropped)

Changed

• Function parse-cron renamed to cron->map

Removed

• Function get-dt-seq removed, use cron->dt instead

v0.1.14 - 2023-07-01

Changed

• Release version's patch part uses git rev-list HEAD --count on main branch.
• Snapshot versions (being generated on merges to main) has 9999-SNAPSHOT patch part

v0.1.3 - 2023-07-01

Added

• Better examples in README.md
• cljdoc config and its check in CI are added

v0.1.2 - 2023-06-30

Fixed

• Generating pom.xml from template fixed

v0.1.1 - 2023-06-30

Added

• Crontab string parsing
• Generation of Date-Time objects satisfying crontab conditions. Objects get generated as a lazy sequence.
• Project CI/CD workflows