Skip to main content
Version: 4.0 (next)

Move between supported 2.x lines

Orientation​

The supported 2.x snapshots are compatibility checkpoints, not claims that every intervening package is breaking. Move through them in order, restore with your real SDK and target frameworks, and regression-test the formatting surfaces your application asserts or persists.

Example​

The package update itself is ordinary. This example is illustrative; choose the target selected in the documentation:

dotnet add package Humanizer --version 2.14.1
dotnet restore --locked-mode
dotnet test

2.10.1 to 2.11.10​

Humanizer.Core 2.11.10 adds a net6.0 asset alongside the existing netstandard1.0 and netstandard2.0 assets. It also introduces DateOnly/TimeOnly support. Recreate or review project.assets.json and test date/time output if your application begins selecting the new asset.

Evidence: tag comparison, DateOnly/TimeOnly change, and the published 2.11.10 package.

2.11.10 to 2.13.14​

This line adds APIs and formatter behavior including byte-rate humanization, time-unit humanization, and a TimeOnly clock strategy. There is no repository evidence of a broad source rewrite comparable to Humanizer 3. Compile first, then test only the affected surfaces you use.

Evidence: tag comparison, byte-rate change, and time-unit change.

2.13.14 to 2.14.1​

The tagged range is dominated by locale corrections and additions rather than a package or namespace migration. Compare localized output that appears in snapshots, persisted data, or exact-string tests. No general source rewrite is required.

Evidence: tag comparison and the published 2.14.1 package.

Pitfall​

Do not interpret “no broad source rewrite” as “no output can change.” Humanizer's value is formatted text, so a locale correction can be observable even when compilation succeeds.

Version notes​

All four supported 2.x Humanizer packages are metapackages whose normal consumer install brings in Humanizer.Core and locale packages. Keep all directly referenced Humanizer package versions aligned; mixed locale/core versions are not an upgrade path.