搜索插件、代码仓与 APP 分类

插件详情v3.0.4

number_to_words_english

支持12种语言的数字转文字,包含货币和序数。适用于Flutter/Dart应用的简单易用的扩展方法。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
6110
喜欢数
37
Pub 分数
150

安装插件

flutter pub add number_to_words_english

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个 Flutter/Dart 包,可将数字转换为英文单词,支持货币和序数形式。它提供直观的扩展方法,可无缝集成到跨平台应用中。设计简洁可靠,使开发者能够以可读文本形式显示数值,非常适合金融应用、报告或用户友好的界面。该包轻量且易于使用,设置简单。

适合场景

  • 在金融应用程序中转换金额
  • 在法律文件中显示数字
  • 生成语音数字格式
  • 创建可访问的 UI 元素
  • 在报告中格式化大数字

主要特点

  • 支持货币和序数转换
  • 易于使用的扩展方法
  • 适用于所有主要平台
  • 轻量且快速
  • 简洁的 API,语法清晰

适合对象

  • 金融和银行应用
  • 教育工具
  • 可访问性功能
  • 文档生成
  • 面向用户的数字显示

使用建议

  • 限制为12种语言(包括英语)
  • 不支持列出以外的非英文区域设置
  • 在某些情况下需要手动处理复数形式
  • 未针对超出标准限制的极大数字进行优化

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

Number to Words English

pub package style: very good analysis License: MIT

A Flutter/Dart package that converts numbers to their written words representation with multi-language support.

Features

✅ Comprehensive multi-language support: 12 languages worldwide
✅ 🆕 Currency conversion: Support for 12 major currencies in all languages
✅ 🆕 Ordinal numbers: 1st, 2nd, 3rd conversion in all languages
✅ Extension methods: Direct conversion with .toWords(), .toUSD(), .toOrdinal(), etc.
✅ Global coverage: Europe, Asia, Middle East, Latin America
✅ Convert integers to written words in 12 languages
✅ Supports numbers from 0 to trillion scale
✅ Null safety support
✅ Lightweight and fast
✅ No external dependencies
✅ Well tested and documented (147+ tests) ✅ Backward compatible - existing code continues to work
✅ Modular architecture - easy to extend with new languages
✅ 🆕 Language accuracy improvements - Vietnamese, Russian, Arabic grammar fixes
✅ 🆕 Code quality optimized - Dart formatting compliance for better pub.dev scores
✅ 🆕 Broader compatibility - Supports Flutter 2.5+ and Dart 2.12+ for legacy projects

Getting started

Add this package to your pubspec.yaml:

dependencies:
  number_to_words_english: ^3.0.4

Then run:

flutter pub get

Usage

Import the package in your Dart file:

import 'package:number_to_words_english/number_to_words_english.dart';
Extension Methods (Recommended)
// Direct number conversion - most convenient!
print(123.toWords()); // English (default)
// Output: 'one hundred twenty-three'

print(123.toVietnamese());
// Output: 'một trăm hai mươi ba'

print(123.toSpanish());
// Output: 'ciento veintitrés'

print(123.toFrench());
// Output: 'cent vingt-trois'

print(123.toGerman());
// Output: 'einhundertdreiundzwanzig'

print(123.toChinese());
// Output: '一百二十三'

print(123.toJapanese());
// Output: 'ひゃくにじゅうさん'

print(123.toArabic());
// Output: 'مائة ثلاثة وعشرون'

// 🆕 Ordinal Numbers (1st, 2nd, 3rd, etc.)
print(1.toOrdinal()); // English (default)
// Output: 'first'

print(21.toOrdinal());
// Output: 'twenty-first'

print(1.toOrdinalVietnamese());
// Output: 'thứ nhất'

print(1.toOrdinalFrench());
// Output: 'premier'

print(1.toOrdinalChinese());
// Output: '第一'

print(1.toOrdinalJapanese());
// Output: '第いち番目'

// 🏦 Currency Conversion (NEW!)
print(123.45.toUSD());
// Output: 'one hundred twenty-three dollars and forty-five cents'

print(123.45.toEUR());
// Output: 'one hundred twenty-three euros and forty-five cents'

print(123.toJPY());
// Output: 'one hundred twenty-three yen'

print(123.45.toVND());
// Output: 'một trăm hai mươi ba đồng và bốn mươi lăm xu'

print(123.45.toCNY());
// Output: '一百二十三人民币四十五角'

// Currency in different languages
print(123.45.toCurrency('USD'));
// Output: 'one hundred twenty-three dollars and forty-five cents'

print(123.45.toCurrencyInLanguage('fr', 'EUR'));
// Output: 'cent vingt-trois euros et quarante-cinq centimes'

print(123.45.toCurrencyInLanguage('es', 'USD'));
// Output: 'ciento veintitrés dólares y cuarenta y cinco centavos'

// Language-specific conversion
print(123.toWordsInLanguage('vi'));
// Output: 'một trăm hai mươi ba'

// Integer-specific methods
print(123.toCardinal()); // Cardinal numbers
print(123.canConvertToWords()); // Validation
print(123.wordCount()); // Word count

// Double-specific methods
print(12.34.toWordsWithDecimal());
print(12.34.integerPartToWords()); // Only integer part
print(12.34.decimalPartToWords()); // Only decimal part

// String conversion
print("123.45".toWordsFromString());
print("123".isValidNumberString()); // Validation
Multi-Language API
// Traditional static method approach
print(NumberToWords.convert('en', 123));
// Output: 'one hundred twenty-three'

print(NumberToWords.convert('vi', 123));
// Output: 'một trăm hai mươi ba'

print(NumberToWords.convert('es', 123));
// Output: 'ciento veintitrés'
Supported Languages (12 Total)
Language Code Language Example (123) Region
en English one hundred twenty-three Global
vi Vietnamese (Tiếng Việt) một trăm hai mươi ba Southeast Asia
es Spanish (Español) ciento veintitrés Latin America
fr French (Français) cent vingt-trois Europe
de German (Deutsch) einhundertdreiundzwanzig Europe
it Italian (Italiano) centoventitre Europe
pt Portuguese (Português) cento e vinte e três Latin America
ru Russian (Русский) сто двадцать три Eastern Europe
zh Chinese (中文) 一百二十三 East Asia
ja Japanese (日本語) ひゃくにじゅうさん East Asia
nl Dutch (Nederlands) honderddrieëntwintig Europe
ar Arabic (العربية) مائة ثلاثة وعشرون Middle East
🥇 Ordinal Numbers (NEW!)

Convert numbers to their ordinal form (1st, 2nd, 3rd, etc.) in multiple languages:

// Basic ordinal conversion
print(NumberToWords.convertOrdinal('en', 1));  // "first"
print(NumberToWords.convertOrdinal('en', 21)); // "twenty-first"
print(NumberToWords.convertOrdinal('en', 101)); // "one hundred first"

// Multi-language ordinals
print(NumberToWords.convertOrdinal('vi', 1));  // "thứ nhất"
print(NumberToWords.convertOrdinal('fr', 1));  // "premier"
print(NumberToWords.convertOrdinal('de', 1));  // "erste"
print(NumberToWords.convertOrdinal('zh', 1));  // "第一"
print(NumberToWords.convertOrdinal('ja', 1));  // "第いち番目"
print(NumberToWords.convertOrdinal('ar', 1));  // "الأول"

// Using extension methods (recommended)
print(1.toOrdinal());                    // "first"
print(2.toOrdinalVietnamese());          // "thứ hai"
print(3.toOrdinalFrench());              // "troisième"
print(4.toOrdinalGerman());              // "vierte"
print(5.toOrdinalChinese());             // "第五"

// Additional integer methods
print(1.toOrdinalWords());               // "first"
print(1.toOrdinalWords('vi'));           // "thứ nhất"
print(21.getOrdinalSuffix());            // "st" (English only)
print(5.canConvertToOrdinal());          // true
💰 Currency Conversion (NEW!)

Convert monetary amounts to their word representation with proper currency names and subunit handling:

// Basic currency conversion using extension methods
print(123.45.toUSD());  // "one hundred twenty-three dollars and forty-five cents"
print(123.45.toEUR());  // "one hundred twenty-three euros and forty-five cents"
print(123.45.toGBP());  // "one hundred twenty-three pounds and forty-five pence"
print(123.toJPY());     // "one hundred twenty-three yen" (no decimals)

// Multi-language currency conversion
print(NumberToWords.convertCurrency('en', 123.45, 'USD'));  // English
// "one hundred twenty-three dollars and forty-five cents"

print(NumberToWords.convertCurrency('vi', 123.45, 'VND'));  // Vietnamese
// "một trăm hai mươi ba đồng và bốn mươi lăm xu"

print(NumberToWords.convertCurrency('fr', 123.45, 'EUR'));  // French
// "cent vingt-trois euros et quarante-cinq centimes"

print(NumberToWords.convertCurrency('zh', 123.45, 'CNY'));  // Chinese
// "一百二十三人民币四十五角"

// Convenient currency-specific methods
print(123.45.toVND());  // Vietnamese Dong
print(123.45.toCNY());  // Chinese Yuan
print(123.45.toCurrencyInLanguage('es', 'EUR'));  // Spanish Euros

Supported Currencies (12 Total):

  • USD (US Dollar), EUR (Euro), GBP (British Pound)
  • JPY (Japanese Yen), VND (Vietnamese Dong), CNY (Chinese Yuan)
  • KRW (Korean Won), THB (Thai Baht), SGD (Singapore Dollar)
  • AUD (Australian Dollar), CAD (Canadian Dollar), CHF (Swiss Franc)
Advanced Multi-Language Examples
// Large numbers in different languages
print(NumberToWords.convert('en', 1000000));
// Output: 'one million'

print(NumberToWords.convert('vi', 1000000));
// Output: 'một triệu'

print(NumberToWords.convert('es', 1000000));
// Output: 'uno millón'

// Grammar improvements - Russian gender agreement for thousands
print(NumberToWords.convert('ru', 1000));
// Output: 'одна тысяча' (feminine form)

// Grammar improvements - Arabic proper word order
print(NumberToWords.convert('ar', 21));
// Output: 'واحد وعشرون' (ones before tens)

// Negative numbers
print(NumberToWords.convert('en', -123));
// Output: 'minus one hundred twenty-three'

print(NumberToWords.convert('vi', -123));
// Output: 'âm một trăm hai mươi ba'

print(NumberToWords.convert('es', -123));
// Output: 'menos ciento veintitrés'

// Decimal numbers
print(NumberToWords.convert('en', 12.34));
// Output: 'twelve point three four'

print(NumberToWords.convert('vi', 12.34));
// Output: 'mười hai phẩy ba tư'

print(NumberToWords.convert('es', 12.34));
// Output: 'doce punto tres cuatro'
Legacy API (Backward Compatible)

The original English-only API continues to work:

// Legacy API - still supported
print(NumberToWordsEnglish.convert(55));
// Output: 'fifty-five'

print(NumberToWordsEnglish.convert(100000));
// Output: 'one hundred thousand'

print(NumberToWordsEnglish.convert(13578921));
// Output: 'thirteen million five hundred seventy-eight thousand nine hundred twenty-one'
Complete example
import 'package:flutter/material.dart';
import 'package:number_to_words_english/number_to_words_english.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Number to Words')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text(
                'Number: 12345',
                style: TextStyle(fontSize: 24),
              ),
              SizedBox(height: 20),
              Text(
                'Words: ${NumberToWordsEnglish.convert(12345)}',
                style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
              ),
            ],
          ),
        ),
      ),
    );
  }
}

API reference

NumberToWords (Multi-Language)
Methods
static String convert(String languageCode, num number)

Converts a number to its word representation in the specified language.

Parameters:

  • languageCode (String): Language code ('en', 'vi', 'es', 'fr', 'de', 'it', 'pt', 'ru', 'zh', 'ja', 'nl', 'ar')
  • number (num): The number to convert (int or double)

Returns:

  • String: The word representation of the number in the specified language.

Example:

String result = NumberToWords.convert('vi', 123);
// Returns: "một trăm hai mươi ba"
static String convertDecimal(String languageCode, String numberStr)

Converts a decimal number string to words in the specified language.

Parameters:

  • languageCode (String): Language code ('en', 'vi', 'es', 'fr', 'de', 'it', 'pt', 'ru', 'zh', 'ja', 'nl', 'ar')
  • numberStr (String): The number as a string (e.g., "123.45")

Returns:

  • String: The word representation of the decimal number.
static List<String> get supportedLanguages

Returns a list of supported language codes.

Returns:

  • List<String>: List of all 12 supported language codes ['en', 'vi', 'es', 'fr', 'de', 'it', 'pt', 'ru', 'zh', 'ja', 'nl', 'ar']
static Map<String, String> get supportedLanguagesWithNames

Returns a map of language codes to language names.

Returns:

  • Map<String, String>: Map of language codes to names
static bool isLanguageSupported(String languageCode)

Checks if a language is supported.

Parameters:

  • languageCode (String): Language code to check

Returns:

  • bool: True if the language is supported
static String convertOrdinal(String languageCode, int number)

Converts a number to its ordinal word representation (1st, 2nd, 3rd, etc.).

Parameters:

  • languageCode (String): Language code ('en', 'vi', 'es', 'fr', 'de', 'it', 'pt', 'ru', 'zh', 'ja', 'nl', 'ar')
  • number (int): Positive integer to convert to ordinal

Returns:

  • String: The ordinal word representation (e.g., "first", "second", "twenty-first")

Example:

String result = NumberToWords.convertOrdinal('en', 21);
// Returns: "twenty-first"
static String convertCurrency(String languageCode, double amount, String currencyCode)

Converts a monetary amount to words with proper currency names.

Parameters:

  • languageCode (String): Language code ('en', 'vi', 'es', 'fr', 'de', 'it', 'pt', 'ru', 'zh', 'ja', 'nl', 'ar')
  • amount (double): Monetary amount to convert
  • currencyCode (String): ISO 4217 currency code ('USD', 'EUR', 'GBP', 'JPY', 'VND', 'CNY', 'KRW', 'THB', 'SGD', 'AUD', 'CAD', 'CHF')

Returns:

  • String: The currency amount in words

Example:

String result = NumberToWords.convertCurrency('en', 123.45, 'USD');
// Returns: "one hundred twenty-three dollars and forty-five cents"
NumberToWordsEnglish (Legacy)
Methods
static String convert(num number)

Converts a number to its English word representation.

Note: This is the legacy API maintained for backward compatibility. For new projects, use NumberToWords.convert('en', number) instead.

Parameters:

  • number (num): The number to convert

Returns:

  • String: The English word representation of the number.

Example:

String result = NumberToWordsEnglish.convert(123);
// Returns: "one hundred twenty-three"

Supported range

This package supports converting integers in the following range:

  • Minimum: 0 (zero)
  • Maximum: 999,999,999,999,999 (nine hundred ninety-nine trillion nine hundred ninety-nine billion nine hundred ninety-nine million nine hundred ninety-nine thousand nine hundred ninety-nine)

Additional information

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Issues and feedback

Please file issues, bugs, or feature requests in our issue tracker.

Links

💖 Support

If you find this package helpful, consider supporting the development:

Buy Me A Coffee

📱 QR Code:

Buy Me A Coffee QR Code

Or visit: coff.ee/kenguyen

License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT License

Copyright (c) 2022 Ke Nguyen

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

所属分类

源码仓库

使用此插件的项目