Number & Currency Conversion Actions Documentation

This documentation describes two actions designed to convert numeric or decimal values into words in a consistent and localized format.

Action: CurrencyToWords

Purpose

Converts a numeric monetary amount between 1 and 999,999,999 into a grammatically correct textual representation, using either the Indian or Western (International) numbering system depending on the currency.

Inputs

Output

Example

Input:

• Amount: 123456.78

• Currency: "INR"

Output:

"One lakh twenty-three thousand four hundred fifty-six rupees and seventy-eight paisas."

All Accepted Currency Codes

INR, PKR, BDT, NPR, AFN, USD, AUD, CAD, NZD, SGD, HKD, TWD, BZD, FJD, ECD, BSD, BND, KYD, LRD, NAD, SBD, SRD, TTD, GBP, GIP, FKP, SHP, EGP, LBP, SYP, SSP, EUR, AED, MAD, QAR, SAR, BHD, KWD, JOD, DZD, OMR, THB, MYR, IDR, PHP, MXN, BRL, NGN, GHS, KES, CHF, VND

Action: NumberToWords

Purpose

Converts any numeric value between 1 and 999,999,999, including optional decimals, into its full textual representation without referencing currency.

Inputs

Output

Example

Input:

• Decimal: "123456.78"

Output:

"One hundred twenty-three thousand four hundred fifty-six point seven eight"