henka-programmer / numbertowords Goto Github PK

View Code? Open in Web Editor NEW

A small extensible library for .NET that converts numbers/currency into words representation with i18n capability.

License: Apache License 2.0

C# 76.08% Batchfile 0.26% PowerShell 23.54% Shell 0.12%

numbertowords's Introduction

NumberToWords

A small extensible library for .NET that converts numbers/currency into words representation with i18n capability.

Get Started

NumberToWords can be installed using the Nuget package manager or the dotnet CLI.

Install-Package H.NumberToWords

Example

Should initialize the static Converter at application startup before usage.

// ...
NumberToWords.Converter.Initialize();
// ...

Then you can use the static instance everywhere

var number = 120.0;
var words = NumberToWords.Converter.ConvertToWords(number);

You can provide extra options such as language and currency.

var number = 22365.0;
NumberToWords.Converter.ConvertToWords(number, options =>
{
    options.CurrencyCode = "USD"; // currency ISO 4217 code.
    options.LanguageCode = "en";  // words language ISO 639-1 code.
    options.LetterCase = NumberToWords.LetterCase.Lowercase; // character casing, lower, upper, title, sintence 
    options.WordSeparator = " "; // words separator by default space
});

or you can use a specific language converter

using NumberToWords.Language;

// ...
var englishConverter = new EnglishNumberToWordsConverter();
var number = 120.0;
var words = englishConverter.ConvertToWords(number);