Nut 3.5.0

NUT - Number To Text

Number To Text Converter

Money To Text Converter

Supported Languages: English, French, German, Russian, Spanish, Turkish, Ukrainian, Bulgarian, Amharic, Polish, Belarussian, Portuguese.

Supported Currencies: EUR, USD, RUB, TRY, UAH, BGN, ETB, PLN, BYN, ARS, BRL.

Number Limit: 1 trillion

Target Framework: .NET Standard 2.0 — runs on .NET Framework 4.6.1+, .NET Core 2.0+ and .NET 5 and later.

INSTALL

dotnet add package Nut

USAGE - Number To Text

    var number = 123456
    var text = number.ToText("en");

    var number = 123456;
    var text = number.ToText(Language.English);

USAGE - Money To Text

    var number = 123456.78
    var moneyText = number.ToText("usd", "en");

    var number = 123456.78;
    var moneyText = number.ToText(Nut.Currency.USD, Nut.Language.English);

    var number = 123456.78;
    var options = new Nut.Options {
        MainUnitNotConvertedToText = true,
        SubUnitNotConvertedToText = true,
        SubUnitZeroNotDisplayed = true,
        MainUnitFirstCharUpper = true,
        SubUnitFirstCharUpper = true,
        CurrencyFirstCharUpper = true
    }
    var moneyText = number.ToText(Nut.Currency.USD, Nut.Language.English, options);

NUGET

https://www.nuget.org/packages/Nut/

CHANGELOG

See CHANGELOG.md for what changed in each release.

CONTRIBUTING

Pull requests are welcome. Two things make them much easier to accept:

• Add tests for what you change. dotnet test src/Nut.sln runs the suite, and CI runs it on every pull request.
• A new language or currency needs tests written by someone who speaks it. Reviewers cannot verify wording in a language they do not read, so a table of expected outputs is the only thing that makes such a contribution reviewable. Cover at least 0, 1, 2, 11, 21, 100, 1000, 2000, 41000, 1000000 plus one decimal amount.

THANKS

• Latif Turk - Ukrainian Language and Currency
• SecreT2k8 - Bulgarian Language and Currency
• ashGHub - .Net Standart Migration, Ethiopian Language and Currency
• kashiash - Polish Language and Currency
• DeNcHiK3713 - Belarussian Language and Currency
• Marciel032 - Portuguese Language and Currency
• ArkadiuszMakosa - Polish Language Unit Tests
• Maryam1986 - German Language and Currency

LICENCE

NUT-number-to-text is MIT licensed.