ordinal_formatter

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

Ordinal Formatter is a lightweight Flutter package that converts integers into their localized ordinal representations, such as turning '2' into '2nd'. It supports multiple languages and locales, making it ideal for displaying ranked items, dates, or sequences in a user-friendly format. The package is easy to integrate and works across Android, iOS, and Web platforms. It handles common ordinal patterns automatically, reducing the need for manual string formatting.

Use cases

Displaying ranked lists
Formatting dates (e.g., 1st of January)
Showing sequence numbers in apps
Localizing ordinal text in multilingual apps
Enhancing readability in UI components

Key features

Automatic localization support
Simple API with minimal setup
Cross-platform compatibility
Handles common ordinal patterns
Lightweight and dependency-free

Suitable for

Apps needing numbered displays
Internationalized applications
Educational or ranking apps
User interfaces with sequential data
Developers seeking minimal text formatting tools

Considerations

Limited to integer inputs
Does not support custom ordinal rules
Requires locale configuration for non-English output
No runtime error handling for invalid inputs
Not suitable for complex linguistic rules beyond standard ordinals

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

A simple flutter plugin to convert numbers into ordinal string using the built in native iOS and android libraries.

Example:

final ordinalString = await OrdinalFormatter().format(2) ?? ''; // ordinalString value: '2nd'

Usage

import 'package:ordinal_formatter/ordinal_formatter.dart';

String ordinalNumber;
try {
    ordinalNumber = await OrdinalFormatter().format(2, 'en_US') ?? 'Unknown number';
} on PlatformException catch (e) {
    ordinalNumber = 'Formatting failed: $e';
}

Features

[X] iOS Support
[X] Android Support
[X] Web support

Search packages, repositories and app categories