https://github.com/moul/number-to-words
convert number into words (english, french, italian, roman, spanish, portuguese, belgium, dutch, swedish, polish, russian, iranian, roman, aegean)
https://github.com/moul/number-to-words
aegean convert-numbers dutch english french iranian italian number number-converter number-spelling number-to-words numbers-to-text polonesa portuguese roman roman-numbers russian spanish swedish
Last synced: 6 months ago
JSON representation
convert number into words (english, french, italian, roman, spanish, portuguese, belgium, dutch, swedish, polish, russian, iranian, roman, aegean)
- Host: GitHub
- URL: https://github.com/moul/number-to-words
- Owner: moul
- License: apache-2.0
- Created: 2016-08-12T06:37:36.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2025-03-06T01:15:34.000Z (7 months ago)
- Last Synced: 2025-03-29T13:06:16.491Z (7 months ago)
- Topics: aegean, convert-numbers, dutch, english, french, iranian, italian, number, number-converter, number-spelling, number-to-words, numbers-to-text, polonesa, portuguese, roman, roman-numbers, russian, spanish, swedish
- Language: Go
- Homepage: https://manfed.life/number-to-words
- Size: 1.32 MB
- Stars: 89
- Watchers: 3
- Forks: 25
- Open Issues: 34
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
- Authors: AUTHORS
Awesome Lists containing this project
README
# number-to-words
:smile: `number-to-words` converts a number to words
[](https://circleci.com/gh/moul/number-to-words)
[](https://godoc.org/moul.io/number-to-words)
[](https://github.com/moul/number-to-words/blob/master/LICENSE)
[](https://github.com/moul/number-to-words/releases)
[](https://goreportcard.com/report/moul.io/number-to-words)
[](https://www.codefactor.io/repository/github/moul/number-to-words)
[](https://codecov.io/gh/moul/number-to-words)
[](https://microbadger.com/images/moul/number-to-words)
[](https://manfred.life/)
## Supported languages
| Code | Flag | Language | Main Region | 42 |
| --------------- | ---- | -------------------------------- | ----------- | ---------------- |
| `en`, `en-us` | 🇺🇸 | American English | USA | forty-two |
| `fr`, `fr-fr` | 🇫🇷 | French, Français | France | quarante-deux |
| `it`, `it-it` | 🇮🇹 | Italiano | Italy | quarantadue |
| `in`, `en-in` | 🇮🇳 | Indian English | India | forty-two |
| `es`, `es-es` | 🇪🇸 | European Spanish | Spain | cuarenta y dos |
| `dk`, `da-dk` | 🇩🇰 | Danish | Denmark | toogfyrre |
| `se`, `sv-se` | 🇸🇪 | Swedish | Sweden | fyrtio-två |
| `nl`, `nl-nl` | 🇳🇱 | Dutch | Netherlands | tweeenveertig |
| `tr`, `tr-tr` | 🇹🇷 | Turkish | Turkey | kırk iki |
| `pt`, `pt-pt` | 🇵🇹 | Portuguese | Portugal | quarenta e dois |
| `pl`, `pl-pl` | 🇵🇱 | Polish | Poland | czterdzieści dwa |
| `ru`, `ru-ru` | 🇷🇺 | Russian | Russia | сорок два |
| `ir`, `ir-ir` | 🇮🇷 | Iranian | Iran | چهل و دو |
| `id`, `id-id` | 🇮🇩 | Indonesian | Indonesia | empat puluh dua |
| `jp`, `ja-jp` | 🇯🇵 | Japanese | Japan | 四十二 |
| `fr-be` | 🇧🇪 | Belgian French, Français (Belge) | Belgium | quarante-deux |
| `uk`, `uk-ua` | 🇺🇦 | Ukrainian | Ukraine | сорок два |
| `roman` | | Roman Numbers | | XLII |
| `roman-unicode` | | Roman (with Unicode) | | ⅩⅬⅡ |
| `aegean` | | Aegean Numerals | | 𐄓𐄈 |
## CLI usage
```console
$ number-to-words --lang=fr 42
quarante-deux
$ number-to-words --lang=fr-be 92
nonante-deux
$ number-to-words --lang=it 42
quarantadue
$ number-to-words --lang=in 42
forty-two
$ number-to-words --lang=es 42
cuarenta y dos
$ number-to-words --lang=en 42
forty-two
$ number-to-words --lang=dk 42
toogfyrre
$ number-to-words --lang=se 42
fyrtio-två
$ number-to-words --lang=nl 42
tweeenveertig
$ number-to-words --lang=pl 42
czterdzieści dwa
$ number-to-words --lang=tr 42
kırk iki
$ number-to-words --lang=pt-pt 42
quarenta e dois
$ number-to-words --lang=roman 42
XLII
$ number-to-words --lang=roman-unicode
ⅩⅬⅡ
$ number-to-words --lang=aegean 42
𐄓𐄈
$ number-to-words --lang=ir 42
چهل و دو
$ number-to-words --lang=id 42
empat puluh dua
```
The default language is English
```console
$ number-to-words 42
forty-two
```
Print different numbers in every supported language
```console
$ number-to-words --lang=all 42
forty-two
quarante-deux
quarante-deux
quarantadue
cuarenta y dos
toogfyrre
fyrtio-två
tweeenveertig
kırk iki
quarenta e dois
XLII
𐄓𐄈
چهل و دو
empat puluh dua
$ number-to-words --lang=all 1
one
un
un
uno
uno
en
en
één
bir
um
I
𐄇
یک
satu
$ number-to-words --lang=all 1337
one thousand three hundred thirty-seven
mille trois cent trente-sept
mille trois cent trente-sept
uno mille trecento trentasette
un mil trescientos treinta y siete
et tusind tre hundrede og syvogtredive
en tusen tre hundra trettio-sju
éénduizend driehonderdzevenendertig
bin üç yüz otuz yedi
mil trezentos e trinta e sete
MCCCXXXVII
𐄢𐄛𐄒𐄍
یک هزار سیصد سی و هفت
seribu tiga ratus tiga puluh tujuh
$ number-to-words --lang=all 1234567890
one arab twenty-three crore forty-five lakh sixty-seven thousand eight hundred ninety
one billion two hundred thirty-four million five hundred sixty-seven thousand eight hundred ninety
un milliard deux cent trente-quatre millions cinq cent soixante-sept mille huit cent quatre-vingt-dix
un milliard deux cent trente-quatre millions cinq cent soixante-sept mille huit cent nonante
uno miliardo duecento trentaquattro milione cinquecento sessentasette mille ottocento novanta
un mil millones doscientos treinta y cuatro millones quinientos sesenta y siete mil ochocientos noventa
en milliard to hundrede og firetredive millioner fem hundrede og syvogtres tusinde ottehundrede og halvfems
en miljarder två hundra trettio-fyra miljoner fem hundra sextio-sju tusen åtta hundra nittio
één miljard tweehonderdvierendertig miljoen vijfhonderdzevenenzestigduizend achthonderdnegentig
bir milyar iki yüz otuz dört milyon beş yüz altmış yedi bin sekiz yüz doksan
mil milhões duzentos e trinta e quatro milhões quinhentos e sessenta e sete mil oitocentos e noventa
یک میلیارد دویست سی و چهار میلیون پانصد شصد و هفت هزار هشتصد نود
satu milyar dua ratus tiga puluh empat juta lima ratus enam puluh tujuh ribu delapan ratus sembilan puluh
$ number-to-words --lang=all 1000000000000
one trillion
un billion
uno triliardo
un billón
en billion
en biljoner
één biljoen
bir trilyon
um bilião
too big number
too big number
satu triliun
```
### `--help`
```console
$ number-to-words -h
NAME:
number-to-words - number to number
USAGE:
number-to-words [global options] command [command options] [arguments...]
VERSION:
0.1.0
AUTHOR(S):
Manfred Touron
COMMANDS:
GLOBAL OPTIONS:
--lang value, -l value Set language (default: "en") [$NTW_LANGUAGE]
--help, -h show help
--version, -v print the version
AVAILABLE LANGUAGES:
European Spanish (es, es-es, es_ES, spanish) 🇪🇸
Belgian French (fr-be, fr_BE, belgian) 🇧🇪
French (fr, fr-fr, fr_FR, french) 🇫🇷
Italian (it, it-it, it_IT, italian) 🇮🇹
Indian English (in, en-in, indian) 🇮🇳
Roman Numbers (with Unicode) (roman-unicode)
Danish (da-dk, da_DK, danish) 🇩🇰
Swedish (sv-se, sv_SE, swedish) 🇸🇪
Aegean (aegean)
American English (en, en-us, es_US, american, english) 🇺🇸 *default*
Dutch (nl, dutch, nl-nl, nl_NL) 🇳🇱
Portuguese (Portugal) (pt, pt-pt, pt_PT, portuguese) 🇵🇹
Polish (Poland) (pl, pl-pl, pl_PL, polish) 🇵🇱
Iranian (Iran) (ir, ir-ir, ir_IR, Iran) 🇮🇷
Indonesian (Indonesia) (id, id-id, id_ID, indonesian) 🇮🇩
Roman Numbers (roman)
```
### Unicode support
Roman support the `--unicode` option.
```console
$ for i in {1..20}; do ./number-to-words -l roman -u $i; done
Ⅰ
Ⅱ
Ⅲ
Ⅳ
Ⅴ
Ⅵ
Ⅶ
Ⅷ
Ⅸ
Ⅹ
Ⅺ
Ⅻ
ⅩⅢ
ⅩⅣ
ⅩⅤ
ⅩⅥ
ⅩⅦ
ⅩⅧ
ⅩⅨ
ⅩⅩ
```
## API usage
```go
import ntw "moul.io/number-to-words"
fmt.Println(ntw.IntegerToFrFr(42)) // french
// Outputs: quarante-deux
```
```go
fmt.Println(ntw.IntegerToFrBe(92)) // belgian french
// Outputs: nonante-deux
fmt.Println(ntw.IntegerToEnUs(42)) // american english
// Outputs: forty-two
fmt.Println(ntw.IntegerToItIt(42)) // italian
// Outputs: quarantadue
fmt.Println(ntw.IntegerToEsEs(42)) // spanish
// Outputs: cuarenta y dos
fmt.Println(ntw.IntegerToDaDk(42)) // danish
// Outputs: toogfyrre
fmt.Println(ntw.IntegerToSvSe(42)) // swedish
// Outputs: fyrtio-två
fmt.Println(ntw.IntegerToNlNl(42)) // dutch
// Outputs: tweeenveertig
fmt.Println(ntw.IntegerToPlPl(42)) // polish
// Outputs: czterdzieści dwa
fmt.Println(ntw.IntegerToTrTr(42)) // turkish
// Outputs: kırk iki
fmt.Println(ntw.IntegerToPtPt(42)) // portuguese (portugal)
// Outputs: quarenta e dois
fmt.Println(ntw.IntegerToRoman(42)) // roman
// Outputs: XLII
fmt.Println(ntw.IntegerToRomanUnicode(42)) // roman (unicode)
// Outputs: ⅩⅬⅡ
fmt.Println(ntw.IntegerToAegean(42)) // aegean (unicode)
// Outputs: 𐄓𐄈
fmt.Println(ntw.IntegerToIrIr(42)) // iranian
// Outputs: چهل و دو
fmt.Println(ntw.IntegerToIDID(42)) // indonesian
// Outputs: empat puluh dua
```
## Install
#### Using Golang
1. install and configure Go on your host
2. get and build: `go get moul.io/number-to-words/cmd/number-to-words`
3. profit: `$GOPATH/bin/number-to-words 42`
#### Using Homebrew
1. install Homebrew
2. install number-to-words: `brew install moul/moul/number-to-words`
3. profit: `number-to-words 42`
#### Using Docker
1. install and configure Docker on your host
2. profit: `docker run --rm moul/number-to-words 42`
## Test
1. profit: `make`
## License
MIT