Amount to Word — Number & Currency to Words for Flutter & Dart #

Convert numbers and money amounts to words in Persian (Farsi), English, Turkish, Arabic, Spanish, and Hindi — with 23 currencies, ordinals, invoice helpers, Indian numbering (lakh/crore), BigInt, and Flutter locale detection.

Ideal for invoices, receipts, banking, e-commerce, and multilingual financial apps.

⭐ If this package saves you time, please star the repo on GitHub — it helps others discover it and keeps development going. Thank you!

12345.toWords(language: Language.fa);  // دوازده هزار و سیصد و چهل و پنج
12.5.toCurrency(currency: CurrencyConfig.usDollar);
// twelve dollars and fifty cents

Why amount_to_word? #

Search keywords: number to words · amount to words · currency to words · Persian number to words · Flutter invoice text · Dart localization · تبدیل عدد به حروف

Table of contents #

• Installation
• Quick start
• Languages
• Currencies
• Number formats
• Features in depth
• Flutter integration
• API overview
• Examples
• Performance
• Contributing
• Support & star
• License

Installation #

Add to pubspec.yaml:

dependencies:
  amount_to_word: ^2.5.1

flutter pub get
# or: dart pub get

Requires Dart ^3.5.0. Core conversion works in any Dart/Flutter app; AmountToWords.fromContext needs a Flutter BuildContext.

Quick start #

import 'package:amount_to_word/amount_to_word.dart';

void main() {
  final fa = AmountToWords(Language.fa);
  final en = AmountToWords(Language.en);

  print(fa.toWords(12345));
  // دوازده هزار و سیصد و چهل و پنج

  print(en.convert(1250.75, currency: CurrencyConfig.usDollar));
  // one thousand two hundred fifty dollars and seventy-five cents

  print(fa.convert(1_000_000, currency: CurrencyConfig.iranianToman));
  // یک میلیون تومان
}

Extensions (one-liners) #

print(123.toWords());                                    // one hundred twenty-three
print(25.toWords(language: Language.fa));                // بیست و پنج
print(21.toWords(language: Language.ar));                // واحد و عشرون
print(21.toWords(language: Language.es));                // veintiuno
print(21.toWords(language: Language.hi));                // इक्कीस

print(12.5.toCurrency(currency: CurrencyConfig.usDollar));
print(1.5.toCurrency(language: Language.hi, currency: CurrencyConfig.indianRupee));

print('۲۵'.toWords(language: Language.fa));
print('١٢'.toWords(language: Language.ar));

Indian numbering & BigInt #

print(100000.toWords(numberingSystem: NumberingSystem.indian)); // one lakh

print(BigInt.parse('1000000000000000000').toWords()); // one quintillion
print(CurrencyConfig.getByCode('GBP')!.getMainUnit(Language.en)); // pound

Ordinals, negatives & invoices #

print(1.toOrdinal());                                    // first
print(21.toOrdinal(language: Language.fa));              // بیست و یکم

print((-5).toWords(allowNegative: true));                // minus five

print(AmountToWords(Language.en).convert(
  100,
  currency: CurrencyConfig.usDollar,
  prefix: 'Amount: ',
  only: true,
));
// Amount: one hundred dollars only

Supported languages #

Supported currencies #

ISO-style lookup: CurrencyConfig.getByCode('INR'). Define custom currencies with CurrencyConfig(...).

Number formats #

final converter = AmountToWords(Language.fa);
print(converter.toMixed(2566)); // ۲ هزار و ۵۶۶
print(converter.convertToMixed(2566.75, currency: CurrencyConfig.usDollar));

Configure thresholds and commas with NumberFormatConfig.

Features in depth #

Custom currency #

final bitcoin = CurrencyConfig(
  mainUnits: {
    Language.en: 'bitcoin',
    Language.fa: 'بیت‌کوین',
  },
  subUnits: {
    Language.en: 'satoshi',
    Language.fa: 'ساتوشی',
  },
  subUnitInMainUnit: 100000000,
);

print(AmountToWords(Language.en).convert(1.5, currency: bitcoin));

Pluralization (examples) #

• English: dollar → dollars, penny → pennies
• Spanish: dólar canadiense → dólares canadienses; apocope un / veintiún
• Hindi: रुपया → रुपये, पैसा → पैसे
• Persian & Turkish: currency units typically uninflected

Range & negatives #

• Default range: 0 … 999,999,999,999,999 (larger via BigInt APIs)
• Negatives throw unless allowNegative: true
• Currency decimals follow subUnitInMainUnit (e.g. KWD: 3 digits)

Packaging #

• Pure Dart: converters, currencies, extensions, ordinals, BigInt, Indian numbering
• Flutter-only: fromContext / of / convertWithContext (locale from BuildContext)

Flutter integration #

import 'package:flutter/material.dart';
import 'package:amount_to_word/amount_to_word.dart';

class PriceDisplay extends StatelessWidget {
  final double amount;
  final CurrencyConfig currency;

  const PriceDisplay({super.key, required this.amount, required this.currency});

  @override
  Widget build(BuildContext context) {
    final converter = AmountToWords.fromContext(context);

    return Text(
      converter.convert(amount, currency: currency),
      style: const TextStyle(fontStyle: FontStyle.italic),
    );
  }
}

Also available: AmountToWords.fromLocale('fa').

API overview #

AmountToWords #

Predefined currencies (selection) #

iranianRial, iranianToman, usDollar, euro, canadianDollar, britishPound, saudiRiyal, uaeDirham, turkishLira, indianRupee, japaneseYen, … — see API docs.

Language #

enum Language { fa, en, tr, ar, es, hi }

Full reference: pub.flutter-io.cn documentation.

Examples #

Runnable samples under /example:

dart pub get
dart run example/example.dart

flutter test

Performance #

Compared to typical alternatives #

Contributing #

Bug reports and PRs are welcome:

1. Open an issue for bugs or language/currency requests
2. For new languages: extend Language, add a ConverterBase implementation, update currencies + tests + docs
3. For new currencies: add CurrencyConfig, register in getAllCurrencies(), cover with tests

Changelog: CHANGELOG.md

Support & star #

⭐ Star this repository #

If amount_to_word helps your product or side project:

→ Star on GitHub

Stars improve discoverability on GitHub and pub.flutter-io.cn, encourage contributions, and signal that multilingual amount-to-words tooling matters to the Flutter community. One click makes a real difference.

Use cases #

• Invoices & receipts (legal amount-in-words lines)
• Banking / fintech UIs
• E-commerce order summaries
• Multilingual accounting & ERP
• Government / education number systems

Supported by #

Built and battle-tested with Fida Invoice — a professional invoice app for Iran (branding, stamps, auto calculations, export).

Get Fida Invoice on Google Play

License #

MIT — see LICENSE.

Convert any amount to words. Ship invoices users can trust.
If you found this useful → ⭐ Star the repo · 👍 Like on pub.flutter-io.cn