PackageTrack
Sign in Get early access

numeral

Composable number formatting and parsing for decimals, compact values, percentages, byte sizes, currency display text, and locale-aware numerals.

4.1.0 3.4K downloads/mo #4428 most downloaded on pub.dev medz/numeral.dart

What this package is like to depend on

Last release 1 months ago

25 Jun 2026

Release timing varies

gaps range from 2 weeks to 1.7 years

Rarely documented

notes for 6 of 25 stable releases

Nothing withdrawn

no release was ever pulled

7 years old

25 releases · first in 2019

3 releases in the last 12 months

see the full history below

Release timeline

25 releases · Dec 2019 to Jun 2026
2020 2021 2022 2023 2024 2025 2026
Release Pre-release

Releases

latest 25
  1. 4.1.0 25 Jun 2026
    Release notes

    What's Changed

    • Added the built-in es.dart language path with Spanish compact units and cardinal number formatting/parsing.
    • Added the built-in ja.dart language path with Japanese compact units, cardinal number formatting/parsing, and digit-by-digit year formatting.
    • Added the built-in ko.dart language path with Korean compact units, Sino-Korean cardinal numbers, and year numbers.
    • Added the built-in fr.dart language path with French compact units, cardinal number formatting/parsing, and year numbers.
    • Added the built-in zh_hant.dart language path with Traditional Chinese compact units, cardinal numbers, year numbers, and financial numerals.

    Published to pub.dev: https://pub.dev/packages/numeral/versions/4.1.0

    Open source →
    Release notes
    • Added a built-in es.dart language path with Spanish compact units and cardinal number formatting/parsing.
    • Added a built-in ja.dart language path with Japanese compact units, cardinal number formatting/parsing, and digit-by-digit year formatting.
    • Added a built-in ko.dart language path with Korean compact units, Sino-Korean cardinal numbers, and year numbers.
    • Added a built-in fr.dart language path with French compact units, cardinal number formatting/parsing, and year numbers.
    • Added a built-in zh_hant.dart language path with Traditional Chinese compact units, cardinal numbers, year numbers, and financial numerals.
    Open source →
  2. 4.0.0 25 Jun 2026
    Release notes
    • Rebuilt the public API around reusable codec classes such as
      DecimalCodec, CompactCodec, PercentCodec,
      BytesCodec, and CurrencyCodec.
    • Added reusable immutable codecs with standard encode/decode support and
      readable format, parse, and tryParse aliases.
    • Added direct parsing support for decimal numbers, compact suffixes,
      percentages, byte sizes, and display currency values.
    • Added decimal and binary byte codecs.
    • Added reusable NumeralUnit / NumeralUnitSet models for unit-based codecs.
    • Added custom number style support for unit-style codecs, allowing currency,
      percentage, byte, and compact formats to compose with language-specific
      number codecs.
    • Added extension.dart for fluent one-off formatting, such as
      12345.compact(), 1536.bytes(binary: true), and 123.currency(r'$').
    • Added built-in en.dart and zh.dart language paths with locale-specific
      compact units, including Simplified Chinese cardinal, year, financial
      numeral, and RMB uppercase amount formatting and parsing.
    • Removed the old num.numeral() / beautiful extension API.
    Open source →
    Release notes
    • Rebuilt the public API around reusable codec classes such as DecimalCodec, CompactCodec, PercentCodec, BytesCodec, and CurrencyCodec.
    • Added reusable immutable codecs with standard encode/decode support and readable format, parse, and tryParse aliases.
    • Added direct parsing support for decimal numbers, compact suffixes, percentages, byte sizes, and display currency values.
    • Added decimal and binary byte codecs.
    • Added reusable NumeralUnit / NumeralUnitSet models for unit-based codecs.
    • Added custom number style support for unit-style codecs, allowing currency, percentage, byte, and compact formats to compose with language-specific number codecs.
    • Added extension.dart for fluent one-off formatting, such as 12345.compact(), 1536.bytes(binary: true), and 123.currency(r'$').
    • Added built-in en.dart and zh.dart language paths with locale-specific compact units, including Simplified Chinese cardinal, year, financial numeral, and RMB uppercase amount formatting and parsing.
    • Removed the old num.numeral() / beautiful extension API.
    Open source →
  3. 3.1.2 02 Oct 2025
    Release notes
    • Handle infinite and NaN values in toStringAsFixedNotRound
    Open source →
  4. 3.1.1 13 May 2025
    Release notes
    • Fixed the issue that the number after the decimal point was incorrect due to inappropriate rounding.
    • test: Added tests
    Open source →
  5. 3.1.0 08 May 2025
    Release notes
    • feat: Added global conf to choose if value should be rounded. #17 at @luis901101
    Open source →
  6. 3.0.0 23 Dec 2023
    Release notes
    • Refactoring code.
    • Support custom unit builder.
    Open source →
  7. 2.0.1 30 Mar 2022

    Nothing published for this version

  8. 2.0.0 30 Mar 2022

    Nothing published for this version

  9. 1.2.5 18 Sep 2021

    Nothing published for this version

  10. 1.2.4 01 Jul 2021

    Nothing published for this version

  11. 1.2.3 28 Jun 2021

    Nothing published for this version

  12. 1.2.2 28 Jun 2021

    Nothing published for this version

  13. 1.2.1 28 Jun 2021

    Nothing published for this version

  14. 1.2.0 28 Jun 2021

    Nothing published for this version

  15. 1.1.0 28 Jun 2021

    Nothing published for this version

  16. 1.0.4 02 Apr 2020

    Nothing published for this version

  17. 1.0.3 02 Apr 2020

    Nothing published for this version

  18. 1.0.2 09 Jan 2020

    Nothing published for this version

  19. 1.0.1 28 Dec 2019

    Nothing published for this version

  20. 1.0.0 28 Dec 2019

    Nothing published for this version

  21. 0.0.5 28 Dec 2019

    Nothing published for this version

  22. 0.0.4 28 Dec 2019

    Nothing published for this version

  23. 0.0.3 28 Dec 2019

    Nothing published for this version

  24. 0.0.2 28 Dec 2019

    Nothing published for this version

  25. 0.0.1 28 Dec 2019

    Nothing published for this version

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive