flutter_number_to_words_english

KO | EN

gitlite — search

#python #hacktoberfest #typescript #go #golang #deep-learning #macos #kubernetes #awesome-list #vue #pytorch #ios #mcp #openai

flutter_number_to_words_english

(★ 11)

https://pub.dev/packages/number_to_words_english

flutter_number_to_words_english 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Number to Words English

[![pub package](https://img.shields.io/pub/v/number_to_words_english.svg)](https://pub.dev/packages/number_to_words_english)
[![style: very good analysis][very_good_analysis_badge]][very_good_analysis_link]
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

[very_good_analysis_badge]: https://img.shields.io/badge/style-very_good_analysis-B22C89.svg
[very_good_analysis_link]: https://pub.dev/packages/very_good_analysis

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`:

```yaml
dependencies:
  number_to_words_english: ^3.0.4
```

Then run:

```bash
flutter pub get
```

## Usage

Import the package in your Dart file:

```dart
import 'package:number_to_words_english/number_to_words_english.dart';
```

### Extension Methods (Recommended)

```dart
// 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

```dart
// 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:

```dart
// 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:

```dart
// 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

```dart
// 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:

```dart
// 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

```dart
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:**

```dart
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:**

```dart
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:**

```dart
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:**

```dart
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](https://github.com/kenguyenduc/flutter_number_to_words_english/issues).

### Links

- [Package on pub.dev](https://pub.dev/packages/number_to_words_english)
- [Source code on GitHub](https://github.com/kenguyenduc/flutter_number_to_words_english)
- [Documentation](https://pub.dev/documentation/number_to_words_english/latest/)

## 💖 Support

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

[![Buy Me A Coffee](https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png)](https://coff.ee/kenguyen)

**📱 QR Code:**

Or visit: [coff.ee/kenguyen](https://coff.ee/kenguyen)

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

```
MIT License

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.
```

flutter_number_to_words_english

flutter_number_to_words_english 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

flutter_number_to_words_english

flutter_number_to_words_english 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README