Skip to content

Add built-in support for Calendar Versioning (CalVer) #2133

@JaeHyuckSa

Description

@JaeHyuckSa

Description

Hatch currently supports PEP 440 semantic versioning, but it has no built-in way to generate Calendar Versioning (e.g., 2025.12.07).
Right now, users must manually set CalVer strings or create external scripts, which makes hatch version less useful for teams using date-based releases.

Use case/motivation

Many projects prefer CalVer for deployment traceability and operational clarity.
If Hatch supported a simple scheme like:

[tool.hatch.version]
scheme = "calendar"
format = "{year}.{month}.{day}"

then users could run:

hatch version

Related issues

None found.

Are you willing to submit a PR?

  • Yes I am willing to submit a PR!

Code of Conduct

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions