croniter

croniter provides iteration for datetime object with cron like format

croniter Permissive license MIT Active ★ 559 v6.2.4 released 2026-07-10

Install

croniter on PyPI

pip

pip install croniter

uv

uv add croniter

poetry

poetry add croniter

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	1 — python-dateutil
Maintenance	actively maintained — 34 days since the last release
Last repo commit	2026-08-08
First released	2010-01-24
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: croniter-6.2.4-py3-none-any.whl

Keywords: cron, datetime, iterator

Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9

About croniter

from the package's own PyPI description — quoted content, verbatim

Introduction

.. contents::

croniter provides iteration for the datetime object with a cron like format.

                      _ _
  ___ _ __ ___  _ __ (_) |_ ___ _ __
 / __| '__/ _ \| '_ \| | __/ _ \ '__|
| (__| | | (_) | | | | | ||  __/ |
 \___|_|  \___/|_| |_|_|\__\___|_|

Website: https://github.com/pallets-eco/croniter

Build Badge

.. image:: https://github.com/pallets-eco/croniter/actions/workflows/cicd.yml/badge.svg :target: https://github.com/pallets-eco/croniter/actions/workflows/cicd.yml

Pallets Community Ecosystem

.. important:: This project is part of the Pallets Community Ecosystem. Pallets is the open source organization that maintains Flask; Pallets-Eco enables community maintenance of Flask extensions. If you are interested in helping maintain this project, please reach out on the Pallets Discord server <https://discord.gg/pallets>_.

Usage

A simple example::

&gt;&gt;&gt; from croniter import croniter
&gt;&gt;&gt; from datetime import datetime
&gt;&gt;&gt; base = datetime(2010, 1, 25, 4, 46)
&gt;&gt;&gt; iter = croniter('*/5 * * * *', base)  # every 5 minutes...

Read as markdown · JSON record · Source repository · Homepage

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

croniter iterates over datetime objects using cron expression syntax, calculating next and previous occurrences of scheduled times. It supports standard cron fields plus extensions like last-day-of-month and nearest-weekday matching.

Low friction: pure Python wheel with only python-dateutil as a runtime dependency. Actively maintained by Pallets Community Ecosystem with recent release (34 days ago) and steady repository activity.

MIT license permits commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Usage

from croniter import croniter
from datetime import datetime
base = datetime(2010, 1, 25, 4, 46)
iter = croniter('*/5 * * * *', base)
print(iter.get_next(datetime))  # 2010-01-25 04:50:00

Requires Python 3.9 or later.

Verdict: croniter is a well-maintained, actively developed library with zero known vulnerabilities and minimal dependencies. Its MIT license and low install friction make it suitable for production scheduling tasks. The package is part of the Pallets Community Ecosystem and supports current Python versions (3.9–3.13).

Needs verification

Whether the package has formal documentation or API stability guarantees beyond the repository README.
Performance characteristics under high-frequency iteration or with complex cron expressions.

cron schedule iteratordatetime cron expressionnext occurrence calculatorcron job timingschedule iteration librarycron format datetimerecurring event scheduler