Crate ordinal

Ordinal formatting

Format numbers as ordinals efficiently. You can get the ordinal suffix e.g., “st”, “nd”, “rd”, or “th” without allocations.

Examples

Get an ordinal suffix without allocating.

use ordinal::ToOrdinal as _;
assert_eq!(12.suffix(), "th");

Format a number as an ordinal, allocating a new String:

use ordinal::ToOrdinal as _;
assert_eq!(12.to_ordinal_string(), "12th");

Get a number representing an ordinal you can use with comparisons and formatting.

use ordinal::ToOrdinal as _;
let n = 12.to_ordinal();
assert_eq!(*n, 12);
assert_eq!(format!("{n}"), "12th");

Structs

Ordinal

Represent numbers as ordinals when displayed.

Traits

ToOrdinal

Format numbers as ordinals e.g., 1st, 12th, 21st, etc.