Tradukisto

Introduction

Tradukisto is a powerful Java library designed to convert numbers into their corresponding word representations.

Our main motivation is to create a production-ready tool providing number conversion for the Polish language. We recognized the need for a well-tested and ready solution that eliminates the hassle of copying and pasting code from different sources. With Tradukisto, you can now transform numbers into their word equivalents easy way!

Features

• Converts Integer to String with numerical representation support.
• Converts Long to String with numerical representation support.
• Converts BigDecimal to String with money representation support.

Supported languages

• 🇧🇷🇵🇹 Brazilian Portuguese
• 🇧🇬 Bulgarian
• 🇭🇷 Croatian
• 🇨🇿 Czech
• 🇳🇱 Dutch
• 🇬🇧 English
• 🇫🇷 French
• 🇩🇪 German
• 🇮🇹 Italian
• 🇰🇿 Kazakh
• 🇱🇻 Latvian
• 🇵🇱 Polish
• 🇷🇺 Russian
• 🇸🇰 Slovak
• 🇺🇦 Ukrainian
• 🇷🇸 Serbian (Latin)
• 🇷🇸 Serbian (Cyrillic)
• 🇹🇷 Turkish

Is your language missing from the list? We encourage you to contribute to our project.

Usage

Add tradukisto as a dependency:

dependencies {
    implementation("pl.allegro.finance:tradukisto:1.12.1")
}

and use it:

ValueConverters intConverter = ValueConverters.ENGLISH_INTEGER;
String valueAsWords = intConverter.asWords(1_234);

assertEquals("one thousand two hundred thirty-four", valueAsWords);

LongValueConverters longConverter = LongValueConverters.ENGLISH_LONG;
String valueAsWords = converter.asWords(1_000_000_000_000_000_000);

assertEquals("one quintillion", valueAsWords);

MoneyConverters converter = MoneyConverters.ENGLISH_BANKING_MONEY_VALUE;

String moneyAsWords = converter.asWords(new BigDecimal("1234.56"));
assertEquals("one thousand two hundred thirty-four £ 56/100", moneyAsWords);

String moneyAsWordsWithCurrency = converter.asWords(new BigDecimal("1234.56", "EUR"));
assertEquals("one thousand two hundred thirty-four EUR 56/100", moneyAsWordsWithCurrency);

Tradukisto can handle only values with no more than two digits after the decimal point. Otherwise, IllegalArgumentException will be thrown. For that reason, you should either construct BigDecimal object based on the String value as shown in the example above or use setScale method to ensure that the given value has appropriate precision.

Changelog

Each release is documented in the release notes.