przemekwa/LiczbyNaSlowaNET

Konwerter liczb na odpowiedniki słowne z zachowaniem polskiej gramatyki.

LiczbyNaSłowaNET

LiczbyNaSłowaNET to biblioteka, która umożliwia konwersje liczb na odpowiedniki słowne z zachowaniem polskiej gramatyki.

Biblioteka dostępna przez nuget-y: https://www.nuget.org/packages/LiczbyNaSlowaNET.dll/

Możliwości biblioteki są następujące:

• Zamiana liczb na odpowiedniki słowne z zachowaniem polskiej gramatyki czyli {"tysiac","tysiace","tysiecy"},
• zamiana liczb typu decimal i int,
• zamiana liczb typu decimal na odpowiedniki walutowe,
• definiowanie własnego separatora liczb typu decimal.
• możliwość ustawiania dowolnej waluty, podczas konwersji liczby na odpowiednik walutowy (ta funkcjonalność powstała dzięki wsparciu społeczności w szcególności użytkownika s13n4 - Tomasz Sienkiewicz). Przykłady znajdują się na dole.

Projekt składa się z 2 solucji:

1. LiczbyNaSlowaNET - jest to głowna bliblioteka służąca do zamiany liczb na słowa.
2. LiczbyNaSlowaNET_Testy - jest to biblioteka z testami.

##Wersja 1.0.0.5

Dzięki wsparciu https://github.com/ZmorzynskiK biblioteka dorobiła się kolejne wersji i sporo przydatnych zmian w kodzie

• dodanie pomocniczych metod do NumberToText
• przejście z int na long (potencjalnie większy zakres)
• usunięcie kilku klas (np NumberToTextOptionBuilder), w ich miejsce inne wywołania
• zmiany w architekturze klasy CurrencyAlgorithm
• uproszczenie interfejsów
• wspólna bazowa klasa BaseCurrencyDeflation
• dostosowanie słowników-deflacji do zmienionego interfejsu ICurrencyDeflation

##Wersja 1.0.0.4

• usunięcie kontenera DI.
• biblioteka już nie potrzebuje zależności innych niż .NET 4.0
• możliwość ustawiania czy tekst ma posadać polskie znaki czy też nie. Domyślnie jest bez polskich znaków.
• możliwość podmienienia słowników zawierających liczebniki.
• dodanie obsługi wartości procentowych

Przykładowe wywołanie i ustawienie słownika z polskimi znakami.

        var options = new NumberToTextOptions
        {
            Stems = true,
            Currency = Currency.PLN,
        };

        Assert.Equal("sześć złotych czterdzieści dziewięć groszy", NumberToText.Convert(6.486M, options));

Szybki start:

Biblioteka LiczbyNaSłowaNET to statyczna klasa NumberToText z metodą Convert, która przyjmuje liczbę typu int lub decimal i zwraca string z odpowiednikiem słownym danej liczby. Dodatkowo można przesłać obiekt NumberToTextOptions, w którym definiujemy walutę i separator liczb dziesiętnych.

Przykłady zastosowań z testów dostępnych w projekcie:

• Zamiana liczb na odpowiedniki słowne (zachowana polskiej gramatyki)

• Assert.AreEqual("osiemdziesiat cztery", NumberToText.Convert(84));
• Assert.AreEqual("sto dwadziescia tysiecy trzydziesci", NumberToText.Convert(120030));
• Assert.AreEqual("osiemset dwadziescia cztery tysiace siedemset dwa", NumberToText.Convert(824702));
• Assert.AreEqual("jeden tysiac dwa", NumberToText.Convert(1002));

• Zamiana liczb typu decimal:

• Assert.AreEqual("czternascie tysiecy sto dwadziescia trzy", NumberToText.Convert(14100.23M));
• Assert.AreEqual("trzynascie zero", NumberToText.Convert(13.0M));

• Zamiana liczb typu decimal na odpowiedniki walutowe:

• Assert.AreEqual("jeden zloty dwadziescia dwa grosze", NumberToText.Convert(1.22M, NumberToText.Currency.PL));
• Assert.AreEqual("dwa zlote szescdziesiat osiem groszy", NumberToText.Convert(2.68M, NumberToText.Currency.PL));
• Assert.AreEqual("zero zlotych dwanascie groszy", NumberToText.Convert(0.12M, NumberToText.Currency.PL));

• Można również przesłać własny string, który rozdzieli liczby po przecinku.

var options = new NumberToTextOptions { curency = Currency.PL, SplitDecimal = "i" };

Assert.AreEqual("dwanascie zlotych i dwadziescia trzy grosze", NumberToText.Convert(12.23M, options));

• Możliwość konwersji liczby na odpowiednik walutowy z możliwością wyboru waluty.

• Assert.Equal("trzynascie euro zero centow", NumberToText.Convert(13.0M, Currency.EUR));
• Assert.Equal("piec funtow brytyjskich zero pensow", NumberToText.Convert(5.00M, Currency.GBP));
• Assert.Equal("piec koron czeskich zero halerzy", NumberToText.Convert(5.00M, Currency.CZK));

Obecnie biblioteka wspiera nastepujące waluty:

public enum Currency { NONE, PLN, CHF, CZK, EUR, HUF, JPY, LTL, NOK, SEK, USD, GBP, PERCENT // nie było lepszego miejsca. To jest wartość procentowa np: sześć procent }

Biblioteka jest bezpieczna w środowisku wielowątkowym(ThreadSafety)

Opis biblioteki znajduje się również na moim blogu: http://blogprogramisty.net/zamiana-liczby-na-slowa-z-polska-gramatyka-c/

Biblioteka jest implementacją algorytmu bazującego na prawidłowości, że każda liczba składa się z trzy cyfrowych elementów oddzielonych rzędami wielkości.

Szczegóły tutaj: http://www.algorytm.org/inne/zamiana-liczby-na-slowa-z-polska-gramatyka.html