Skip to content
BENIBIX Learn

Semantic Versioning vs Calendar Versioning

People think every version number says how big a change is, and it does not. In semantic versioning it does: 3.0.0 warns that old code may break. In calendar versioning the number is a date, so 24.04 means April 2024. A jump there only tells you time has passed. Check which kind a project uses before you read its numbers.

Development🚀 Product & Releases

Semantic Versioning (SemVer)

Version numbers in three parts. They say how big a change is.

Semantic versioning is a rule for version numbers in three parts, like 2.4.1. The parts are MAJOR.MINOR.PATCH. You raise PATCH for a bug fix that changes nothing else. You raise MINOR for a new feature that old code can ignore. You raise MAJOR when something old stops working. So 2.4.1 to 2.5.0 should be safe, but 2.x to 3.0 may break your code.

Example
Jack's library is at 1.2.3. He adds a new option, so it becomes 1.3.0. Later he removes an old function, so it becomes 2.0.0.
Why it matters
Tools read these numbers to decide which updates are safe to install by themselves.
Full entry
Development🚀 Product & Releases

Calendar Versioning (CalVer)

Version numbers made from the release date, like 24.04 for April 2024.

Calendar versioning is a way to number releases by the date they came out. Ubuntu 24.04 came out in April 2024, so the number is the year and the month. The number tells you how old a version is, but not how big the change was. It suits software that ships on a fixed plan, like a new system every six months.

Example
Lucy sees two servers, one on Ubuntu 22.04 and one on 24.04. Without looking anything up, she knows the first one is two years older.
Why it matters
Many big projects use dates, not semantic versions. Reading the number right tells you how out of date a system is.
Full entry

In one line

Semantic Versioning (SemVer)
Version numbers in three parts. They say how big a change is.
Calendar Versioning (CalVer)
Version numbers made from the release date, like 24.04 for April 2024.