# Supported Languages

> **Auto-generated** — Do not edit manually. Run `npm run docs:languages` to update.

n2words supports **72 languages** with cardinal number conversion, 72 with ordinal support, 72 with currency support.

Language codes follow [IETF BCP 47](https://tools.ietf.org/html/bcp47) standards.

## All Languages

|Code|Language|Cardinal|Ordinal|Currency|
|----|--------|:------:|:-----:|:------:|
|`am-ET`|Amharic (Ethiopia)|10^12 - 1|10^12 - 1|10^12 - 1|
|`am-Latn-ET`|Amharic (Latin, Ethiopia)|10^12 - 1|10^12 - 1|10^12 - 1|
|`ar-SA`|Arabic (Saudi Arabia)|10^24 - 1 [*](#arabic-saudi-arabia-ar-sa)|10^24 - 1 [*](#arabic-saudi-arabia-ar-sa)|10^24 - 1|
|`az-AZ`|Azerbaijani (Azerbaijan)|10^21 - 1|10^21 - 1|10^21 - 1|
|`bn-BD`|Bangla (Bangladesh)|10^19 - 1|10^19 - 1|10^19 - 1|
|`cs-CZ`|Czech (Czechia)|10^30 - 1|10^30 - 1|10^30 - 1|
|`da-DK`|Danish (Denmark)|10^30 - 1|10^30 - 1|10^30 - 1|
|`de-DE`|German (Germany)|10^30 - 1|10^30 - 1|10^30 - 1 [*](#german-germany-de-de)|
|`el-GR`|Greek (Greece)|10^15 - 1|10^9 - 1|10^15 - 1|
|`en-AU`|Australian English|10^66 - 1|10^66 - 1|10^66 - 1 [*](#australian-english-en-au)|
|`en-BD`|English (Bangladesh)|10^19 - 1|10^19 - 1|10^19 - 1 [*](#english-bangladesh-en-bd)|
|`en-CA`|Canadian English|10^66 - 1 [*](#canadian-english-en-ca)|10^66 - 1|10^66 - 1 [*](#canadian-english-en-ca)|
|`en-GB`|British English|10^66 - 1|10^66 - 1|10^66 - 1 [*](#british-english-en-gb)|
|`en-GH`|English (Ghana)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-ghana-en-gh)|
|`en-IE`|English (Ireland)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-ireland-en-ie)|
|`en-IN`|English (India)|10^19 - 1|10^19 - 1|10^19 - 1 [*](#english-india-en-in)|
|`en-KE`|English (Kenya)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-kenya-en-ke)|
|`en-MY`|English (Malaysia)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-malaysia-en-my)|
|`en-NG`|English (Nigeria)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-nigeria-en-ng)|
|`en-NZ`|English (New Zealand)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-new-zealand-en-nz)|
|`en-PH`|English (Philippines)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-philippines-en-ph)|
|`en-PK`|English (Pakistan)|10^19 - 1|10^19 - 1|10^19 - 1 [*](#english-pakistan-en-pk)|
|`en-SG`|English (Singapore)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-singapore-en-sg)|
|`en-US`|American English|10^66 - 1 [*](#american-english-en-us)|10^66 - 1|10^66 - 1 [*](#american-english-en-us)|
|`en-ZA`|English (South Africa)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#english-south-africa-en-za)|
|`es-ES`|European Spanish|10^30 - 1 [*](#european-spanish-es-es)|10^9 - 1 [*](#european-spanish-es-es)|10^30 - 1 [*](#european-spanish-es-es)|
|`es-MX`|Mexican Spanish|10^30 - 1 [*](#mexican-spanish-es-mx)|10^9 - 1 [*](#mexican-spanish-es-mx)|10^30 - 1 [*](#mexican-spanish-es-mx)|
|`es-US`|Spanish (United States)|10^21 - 1 [*](#spanish-united-states-es-us)|10^9 - 1 [*](#spanish-united-states-es-us)|10^21 - 1 [*](#spanish-united-states-es-us)|
|`fa-IR`|Persian (Iran)|∞|∞|∞|
|`fi-FI`|Finnish (Finland)|10^18 - 1|10^18 - 1|10^18 - 1|
|`fil-PH`|Filipino (Philippines)|10^15 - 1|10^15 - 1|10^15 - 1|
|`fr-BE`|French (Belgium)|10^30 - 1 [*](#french-belgium-fr-be)|10^30 - 1|10^30 - 1 [*](#french-belgium-fr-be)|
|`fr-FR`|French (France)|10^30 - 1 [*](#french-france-fr-fr)|10^30 - 1|10^30 - 1 [*](#french-france-fr-fr)|
|`gu-IN`|Gujarati (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`ha-NG`|Hausa (Nigeria)|10^12 - 1|10^12 - 1|10^12 - 1|
|`hbo-IL`|Biblical Hebrew (Israel)|10^21 - 1 [*](#biblical-hebrew-israel-hbo-il)|10^9 - 1|10^21 - 1|
|`he-IL`|Hebrew (Israel)|10^21 - 1 [*](#hebrew-israel-he-il)|10^9 - 1|10^21 - 1|
|`hi-IN`|Hindi (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`hr-HR`|Croatian (Croatia)|10^30 - 1 [*](#croatian-croatia-hr-hr)|10^15 - 1|10^30 - 1|
|`hu-HU`|Hungarian (Hungary)|∞|∞|∞|
|`id-ID`|Indonesian (Indonesia)|10^36 - 1|10^36 - 1|10^36 - 1|
|`it-IT`|Italian (Italy)|10^66 - 1|10^66 - 1|10^66 - 1 [*](#italian-italy-it-it)|
|`ja-JP`|Japanese (Japan)|10^72 - 1|10^72 - 1|10^72 - 1|
|`ka-GE`|Georgian (Georgia)|10^24 - 1|10^24 - 1|10^24 - 1|
|`kn-IN`|Kannada (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`ko-KR`|Korean (South Korea)|10^32 - 1|10^32 - 1|10^32 - 1|
|`lt-LT`|Lithuanian (Lithuania)|10^30 - 1 [*](#lithuanian-lithuania-lt-lt)|10^15 - 1|10^30 - 1|
|`lv-LV`|Latvian (Latvia)|10^30 - 1 [*](#latvian-latvia-lv-lv)|10^15 - 1|10^30 - 1|
|`mr-IN`|Marathi (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`ms-MY`|Malay (Malaysia)|10^15 - 1|10^15 - 1|10^15 - 1|
|`nb-NO`|Norwegian Bokmål (Norway)|10^30 - 1|10^30 - 1|10^30 - 1|
|`nl-NL`|Dutch (Netherlands)|10^30 - 1 [*](#dutch-netherlands-nl-nl)|10^21 - 1|10^30 - 1 [*](#dutch-netherlands-nl-nl)|
|`pa-IN`|Punjabi (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`pl-PL`|Polish (Poland)|10^33 - 1 [*](#polish-poland-pl-pl)|10^24 - 1|10^33 - 1|
|`pt-BR`|Brazilian Portuguese|10^27 - 1|10^24 - 1|10^27 - 1 [*](#brazilian-portuguese-pt-br)|
|`pt-PT`|European Portuguese|10^27 - 1|10^21 - 1|10^27 - 1 [*](#european-portuguese-pt-pt)|
|`ro-RO`|Romanian (Romania)|10^30 - 1 [*](#romanian-romania-ro-ro)|10^9 - 1|10^30 - 1|
|`ru-RU`|Russian (Russia)|10^33 - 1 [*](#russian-russia-ru-ru)|10^33 - 1|10^33 - 1 [*](#russian-russia-ru-ru)|
|`sr-Cyrl-RS`|Serbian (Cyrillic, Serbia)|10^30 - 1 [*](#serbian-cyrillic-serbia-sr-cyrl-rs)|10^30 - 1|10^30 - 1 [*](#serbian-cyrillic-serbia-sr-cyrl-rs)|
|`sr-Latn-RS`|Serbian (Latin, Serbia)|10^30 - 1 [*](#serbian-latin-serbia-sr-latn-rs)|10^30 - 1|10^30 - 1 [*](#serbian-latin-serbia-sr-latn-rs)|
|`sv-SE`|Swedish (Sweden)|10^27 - 1|10^27 - 1|10^27 - 1|
|`sw-KE`|Swahili (Kenya)|10^21 - 1|10^21 - 1|10^21 - 1|
|`ta-IN`|Tamil (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`te-IN`|Telugu (India)|10^19 - 1|10^19 - 1|10^19 - 1|
|`th-TH`|Thai (Thailand)|∞|∞|∞|
|`tr-TR`|Turkish (Türkiye)|10^21 - 1 [*](#turkish-türkiye-tr-tr)|10^21 - 1|10^21 - 1|
|`uk-UA`|Ukrainian (Ukraine)|10^30 - 1 [*](#ukrainian-ukraine-uk-ua)|10^15 - 1|10^30 - 1|
|`ur-PK`|Urdu (Pakistan)|10^19 - 1|10^19 - 1|10^19 - 1|
|`vi-VN`|Vietnamese (Vietnam)|10^21 - 1|10^21 - 1|10^21 - 1|
|`yo-NG`|Yoruba (Nigeria)|∞|∞|∞|
|`zh-Hans-CN`|Chinese (Simplified, China)|10^16 - 1 [*](#chinese-simplified-china-zh-hans-cn)|10^16 - 1 [*](#chinese-simplified-china-zh-hans-cn)|10^16 - 1 [*](#chinese-simplified-china-zh-hans-cn)|
|`zh-Hant-TW`|Chinese (Traditional, Taiwan)|10^16 - 1 [*](#chinese-traditional-taiwan-zh-hant-tw)|10^16 - 1 [*](#chinese-traditional-taiwan-zh-hant-tw)|10^16 - 1 [*](#chinese-traditional-taiwan-zh-hant-tw)|

Each form column shows the largest value it converts (`10^N - 1`), `∞` when unbounded, or blank when the form isn't supported.

\* Has options — click to jump to that language's options.

## Usage

```js
// Import language modules directly
import { toCardinal } from 'n2words/en-US'
import { toCardinal, toOrdinal, toCurrency } from 'n2words/en-US'

toCardinal(42)     // 'forty-two'
toOrdinal(42)      // 'forty-second' (if supported)
toCurrency(42.50)  // 'forty-two dollars and fifty cents' (if supported)
```

### Import Paths

Import paths use BCP 47 language codes: `n2words/en-US`, `n2words/zh-Hans-CN`, `n2words/fr-BE`

## Language Options

41 languages support options via a second parameter. Options are passed as an object:

```js
toCardinal(value, { optionName: value })
toCurrency(value, { optionName: value })
```

### American English (`en-US`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`hundredPairing`|cardinal|`boolean`|`false`|Use hundred-pairing for 1100-9999 (e.g., "fifteen hundred" instead of "one thousand five hundred")|
|`and`|cardinal|`boolean`|`false`|Use "and" after hundreds and before final small numbers (e.g., "one hundred and one" instead of "one hundred one")|
|`and`|currency|`boolean`|`true`|Use "and" between dollars and cents (e.g., "one dollar and fifty cents")|

### Arabic (Saudi Arabia) (`ar-SA`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`negativeWord`|cardinal|`string`|`ناقص`|Custom word for negative numbers|
|`gender`|ordinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|

### Australian English (`en-AU`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between dollars and cents|

### Biblical Hebrew (Israel) (`hbo-IL`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`andWord`|cardinal|`string`|`ו`|Custom conjunction word|

### Brazilian Portuguese (`pt-BR`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Include "e" between major and minor units|
|`currency`|currency|`string`|—|Currency code (e.g., 'BRL', 'USD'); empty means auto-detect for pt-BR|

### British English (`en-GB`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between pounds and pence (e.g., "one pound and fifty pence")|

### Canadian English (`en-CA`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`hundredPairing`|cardinal|`boolean`|`false`|Use hundred-pairing for 1100-9999 (e.g., "fifteen hundred" instead of "one thousand five hundred")|
|`and`|cardinal|`boolean`|`true`|Use "and" after hundreds and before final small numbers (default: true, Canadian/British style)|
|`and`|currency|`boolean`|`true`|Use "and" between dollars and cents (e.g., "one dollar and fifty cents")|

### Chinese (Simplified, China) (`zh-Hans-CN`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`formal`|cardinal|`boolean`|`true`|Use formal/financial numerals|
|`formal`|ordinal|`boolean`|`true`|Use formal/financial numerals|
|`formal`|currency|`boolean`|`true`|Use formal/financial numerals|

### Chinese (Traditional, Taiwan) (`zh-Hant-TW`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`formal`|cardinal|`boolean`|`true`|Use formal/financial numerals|
|`formal`|ordinal|`boolean`|`true`|Use formal/financial numerals|
|`formal`|currency|`boolean`|`true`|Use formal/financial numerals|

### Croatian (Croatia) (`hr-HR`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|

### Dutch (Netherlands) (`nl-NL`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`accentOne`|cardinal|`boolean`|`true`|Use "één" instead of "een"|
|`includeOptionalAnd`|cardinal|`boolean`|`false`|Include "en" before small numbers|
|`noHundredPairing`|cardinal|`boolean`|`false`|Disable hundred pairing (1104→duizend honderdvier)|
|`and`|currency|`boolean`|`true`|Include "en" between euros and cents|

### English (Bangladesh) (`en-BD`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between taka and paise|

### English (Ghana) (`en-GH`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between cedis and pesewas|

### English (India) (`en-IN`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between rupees and paise|

### English (Ireland) (`en-IE`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between euro and cent (e.g., "one euro and fifty cents")|

### English (Kenya) (`en-KE`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between shillings and cents|

### English (Malaysia) (`en-MY`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between ringgit and sen|

### English (New Zealand) (`en-NZ`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between dollars and cents|

### English (Nigeria) (`en-NG`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between naira and kobo (e.g., "one naira and fifty kobo")|

### English (Pakistan) (`en-PK`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between rupees and paise|

### English (Philippines) (`en-PH`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between pesos and centavos|

### English (Singapore) (`en-SG`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between dollars and cents|

### English (South Africa) (`en-ZA`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "and" between rand and cents (e.g., "one rand and fifty cents")|

### European Portuguese (`pt-PT`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Include "e" between euros and cents|

### European Spanish (`es-ES`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`gender`|ordinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`and`|currency|`boolean`|`true`|Use "con" between euros and cents|

### French (Belgium) (`fr-BE`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`withHyphenSeparator`|cardinal|`boolean`|`false`|Use hyphens between words|
|`and`|currency|`boolean`|`true`|Use "et" between euros and centimes|

### French (France) (`fr-FR`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`withHyphenSeparator`|cardinal|`boolean`|`false`|Use hyphens between all words|
|`and`|currency|`boolean`|`true`|Use "et" between euros and centimes|

### German (Germany) (`de-DE`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "und" between euros and cents|

### Hebrew (Israel) (`he-IL`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`andWord`|cardinal|`string`|`ו`|Custom conjunction word|

### Italian (Italy) (`it-IT`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`and`|currency|`boolean`|`true`|Use "e" between euros and centesimi|

### Latvian (Latvia) (`lv-LV`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Gender for numbers < 1000|

### Lithuanian (Lithuania) (`lt-LT`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Gender for numbers < 1000|

### Mexican Spanish (`es-MX`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`gender`|ordinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`and`|currency|`boolean`|`true`|Use "con" between pesos and centavos|

### Polish (Poland) (`pl-PL`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Gender for numbers < 1000|

### Romanian (Romania) (`ro-RO`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Gender for numbers|

### Russian (Russia) (`ru-RU`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`and`|currency|`boolean`|`true`|Use "и" between rubles and kopecks|

### Serbian (Cyrillic, Serbia) (`sr-Cyrl-RS`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`and`|currency|`boolean`|`true`|Use "и" between dinars and para|

### Serbian (Latin, Serbia) (`sr-Latn-RS`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`and`|currency|`boolean`|`true`|Use "i" between dinars and para|

### Spanish (United States) (`es-US`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`gender`|ordinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|
|`and`|currency|`boolean`|`true`|Use "con" between dollars and cents|

### Turkish (Türkiye) (`tr-TR`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`dropSpaces`|cardinal|`boolean`|`false`|Remove spaces for compound form|

### Ukrainian (Ukraine) (`uk-UA`)

|Option|Form|Type|Default|Description|
|------|----|----|-------|-----------|
|`gender`|cardinal|'masculine' \| 'feminine'|`masculine`|Grammatical gender|