click-datetime
Datetime type support for click.
Decision gist · record as of 2026-08-14
Yes, if you are building a Click CLI that needs datetime parameters and you are comfortable with a dormant package. The code is simple and the dependency footprint is minimal. No security vulnerabilities are known. The main trade-off is that you receive no active maintenance—if a bug appears or Click changes its internals, you will need to maintain a patch yourself or implement datetime parsing inline. For straightforward date-parameter use cases, the convenience outweighs the risk.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later (package specifies >=3.12,<4.0).
- Low friction installation with only two runtime dependencies (click and wheel).
- Package is dormant—last release was 704 days ago—so expect no active maintenance or bug fixes.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use this package freely in commercial and open-source projects with minimal restrictions.
last release 2024-09-09 (704 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 75,483 downloads/mo, #14,708 on PyPI
Alternatives
Verify before relying
pip install click-datetime
from datetime import datetime
import click
from click_datetime import Datetime
@click.command()
@click.option('--date', type=Datetime(format='%Y-%m-%d'))
def cli(date):
click.echo(f'Date: {date}')
if __name__ == '__main__':
cli()- Whether the package works correctly with recent versions of Click (no changelog provided to confirm compatibility).
- Whether datetime parsing handles edge cases like timezone-aware datetimes or invalid format strings gracefully.
- Real-world stability and bug-fix responsiveness given dormant maintenance status.
What it is and what it does
Click-datetime is a small extension that teaches Click how to parse datetime values from command-line arguments. It wraps Python's datetime type as a Click parameter type, letting you define a format string and automatically convert user input into datetime objects. The package sits between Click's parameter system and Python's datetime module, handling the string-to-object conversion so your CLI code receives properly typed datetime values instead of raw strings.
The package is straightforward: you instantiate a Datetime type with a format string, attach it to a Click option or argument, and the conversion happens automatically. It has no external dependencies beyond Click itself. However, the package is dormant—the last release was 704 days ago—so it receives no active maintenance. If you need datetime parsing in a Click CLI and the format is simple, this package works; if you encounter bugs or need support for complex datetime scenarios, you may need to patch it yourself or implement the conversion inline.
Use it for
- Accept a date parameter in a CLI tool and receive a datetime object directly without manual string parsing.
- Build a backup or log-analysis CLI that takes date ranges as command-line arguments with automatic validation.
- Create a scheduling CLI where users specify dates in a consistent format and your code validates them automatically.
- Develop a data-processing script that accepts date filters from the command line with format validation built in.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are building a Click CLI that needs datetime parameters and you are comfortable with a dormant package.
The code is simple and the dependency footprint is minimal. No security vulnerabilities are known. The main trade-off is that you receive no active maintenance—if a bug appears or Click changes its internals, you will need to maintain a patch yourself or implement datetime parsing inline. For straightforward date-parameter use cases, the convenience outweighs the risk.
Install
click-datetime on PyPI
Before you install
Low friction installation with only two runtime dependencies (click and wheel). Package is dormant—last release was 704 days ago—so expect no active maintenance or bug fixes.
Requires Python 3.12 or later (package specifies >=3.12,<4.0).
License in practice
MIT license is permissive; you can use this package freely in commercial and open-source projects with minimal restrictions.
Quickstart
pip install click-datetime
from datetime import datetime
import click
from click_datetime import Datetime
@click.command()
@click.option('--date', type=Datetime(format='%Y-%m-%d'))
def cli(date):
click.echo(f'Date: {date}')
if __name__ == '__main__':
cli()Verify before relying
- Whether the package works correctly with recent versions of Click (no changelog provided to confirm compatibility).
- Whether datetime parsing handles edge cases like timezone-aware datetimes or invalid format strings gracefully.
- Real-world stability and bug-fix responsiveness given dormant maintenance status.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesclickwheel |
| Maintenance | Dormant 704 days since the last release |
| First released | |
| Downloads | 75,483 / month, #14,708 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.12 |
Evidence: click_datetime-0.4.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “click datetime parsing”
- click-datetimeAdds datetime type support to Click, allowing CLI developers to parse…
- aniso8601Parses ISO 8601 date, time, datetime, duration, and interval strings…
- udatetimeudatetime provides fast RFC3339-compliant date-time parsing,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also click · click-config-file · more-click · cligj · click-configfile · click-prompt · click-help-colors · click-compose · click-option-group · rich-click