Facilitates currency management by providing classes for handling ISO 4217 currency codes and details, including code validation and retrieval of internationalized currency information.
-blue.svg)
Kotlin multiplatform currency library.
This is most useful in combination with fluid-i18n for retrieving internationalized information about a currency.
build.gradle.kts:
dependencies {
implementation("io.fluidsonic.currency:fluid-currency:0.14.0")
}
println(Currency.forCode("EUR")) // EUR
class CurrencyA class with information about a specific currency defined by ISO 4217.
val currency = Currency.forCode("EUR") // throws if code is invalid (not defined by ISO 4217) or has an invalid format (not three latin letters)
println(currency.code) // EUR
println(currency.defaultFractionDigits) // 2
println(currency.numericCode) // 978
val currency = Currency.forCodeOrNull("ABC123") // null if code is invalid (not defined by ISO 4217) or has an invalid format (not three latin letters)
println(currency) // null
value class CurrencyCodeA value class for ISO 4217 3-letter currency codes (e.g. EUR or USD).
Supports kotlinx.serialization out of the box.
val code = CurrencyCode.parse("EUR") // throws if code has invalid format (not three latin letters)
println(code.toString()) // EUR
println(code.isValid()) // true - 'EUR' is defined by ISO 4217
val code = CurrencyCode.parse("abc") // throws if code has invalid format (not three latin letters)
println(code.toString()) // ABC
println(code.isValid()) // false - 'ABC' is not defined by ISO 4217
val code = CurrencyCode.parseOrNull("ABC123") // null if code has invalid format (not three latin letters)
println(code) // null
On the JVM, extension functions are provided for converting between this library's Currency and java.util.Currency:
val platformCurrency: java.util.Currency = Currency.forCode("EUR").toPlatform()
val commonCurrency: Currency = platformCurrency.toCommon()
Apache 2.0
Surfaced from shared tags and platforms — no rankings paid for.