kwn/number-to-words
Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages.
3.0.1
5.6M downloads/mo
#2178 most downloaded on Packagist
kwn/number-to-words
What this package is like to depend on
Last release 1 months ago
13 Jul 2026
Release timing varies
gaps range from 9 days to 12 months
Rarely documented
notes for 10 of 76 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
76 releases · first in 2015
2 releases in the last 12 months
see the full history below
Release timeline
76 releases · Dec 2015 to Jul 2026Releases
latest 60 of 76-
3.0.113 Jul 2026Release notes
Open source →What's Changed
- Hungarian: fixed to be conform... by @donatmarko in #198
New Contributors
- @donatmarko made their first contribution in #198
Full Changelog: 3.0.0...3.0.1
-
3.0.021 Jun 2026Release notes
Open source →Breaking Changes
- ROL → RON: Romanian currency code updated from deprecated ROL to current ISO 4217 code RON across all transformers
- PHPUnit 9 → 11: Test infrastructure upgraded (requires PHP 8.2+)
New Features
- Base currency list: All currency transformers now support a canonical set of 51 currencies. Previously several transformers had only 2–14 currencies; all now have full coverage
- MXN (Mexican Peso): Added to all currency transformers that were missing it
- Malay currency transformer: MalaysianCurrencyTransformer renamed to MalayCurrencyTransformer for naming consistency with MalayNumberTransformer
Bug Fixes
- Swedish: Fixed capitalized Minus prefix, sjutio → sjuttio (70), missing plural inflection for millions/billions
- Danish: Missing og connector after hundreds (e.g. et hundrede en → et hundrede og en)
- German currency: eins Euro → ein Euro for amounts of 1, and ein tausend → eintausend (wrong word separator)
- Yoruba: Zero returned empty string instead of odo
- Romanian currency: Negative amounts ignored the minus sign
Test Coverage
- Added ~120 new test cases across 16 transformers covering: negative numbers, full numeric ranges, and newly added currencies
- Added MXN test cases in 8 languages (English, German, Polish, Russian, Spanish, French, Danish, Turkish)
CI / Infrastructure
- Migrated from Code Climate to Qlty.sh for coverage reporting (QLTY_COVERAGE_TOKEN)
- xdebug now installed via pecl instead of deprecated install-php-extensions (fixes PHP 8.5 support)
- HTML coverage report saved as CircleCI artifact
- PHPUnit annotations (@dataProvider) replaced with PHP 8 attributes (#[DataProvider])
- Data provider methods made public static (PHPUnit 11 requirement)
- Abstract base test classes renamed: CurrencyTransformerTest → CurrencyTransformerTestCase, NumberTransformerTest → NumberTransformerTestCase
Removed
- src/Legacy/Numbers/Words/Locale/Uz.php: dead code - Uzbek has its own modern transformer
-
2.12.001 Jul 2025Release notes
Open source →What's Changed
- Added actual currency names in Bulgarian! by @savemetenminutes in #186
- Add Portuguese (Portugal) by @rguedes in #191
New Contributors
- @savemetenminutes made their first contribution in #186
- @rguedes made their first contribution in #191
Full Changelog: 2.11.2...2.12.0
-
2.11.207 Jan 2025 -
2.11.114 Nov 2024 -
2.11.004 Nov 2024Release notes
Open source →What's Changed
- Added alias fr_FR for french locale (fr) by @Bryce-Colton in #175
New Contributors
- @Bryce-Colton made their first contribution in #175
Full Changelog: 2.10.0...2.11.0
-
2.10.018 Sep 2024Release notes
Open source →What's Changed
- Fix for Indonesia Language naming by @ngekoding in #179
- Add Swahili Language Support by @titustum in #181
New Contributors
- @ngekoding made their first contribution in #179
- @titustum made their first contribution in #181
Full Changelog: 2.9.1...2.10.0
-
2.9.124 Feb 2024Release notes
Open source → -
2.9.024 Feb 2024Release notes
Open source →What's Changed
- Added Bulgarian currency transformer. by @gkangelov in #169
New Contributors
- @gkangelov made their first contribution in #169
Full Changelog: 2.8.0...2.9.0
-
2.8.004 Dec 2023Release notes
Open source →What's Changed
- Uzbek language added by @develgold in #164
- Update readme file by @kwn in #165
New Contributors
- @develgold made their first contribution in #164
Full Changelog: 2.7.2...2.8.0
-
2.7.216 Sep 2023Nothing published for this version
-
2.7.116 Sep 2023Nothing published for this version
-
2.7.016 Sep 2023Nothing published for this version
-
2.6.403 May 2023Nothing published for this version
-
2.6.303 May 2023Nothing published for this version
-
2.6.224 Feb 2023Nothing published for this version
-
2.6.101 Dec 2022Nothing published for this version
-
2.6.012 Nov 2022Nothing published for this version
-
2.5.004 Aug 2022Nothing published for this version
-
2.4.319 Jul 2022Nothing published for this version
-
2.4.208 Jul 2022Nothing published for this version
-
2.4.104 Jul 2022Nothing published for this version
-
2.4.004 May 2022Nothing published for this version
-
2.3.107 Apr 2022Nothing published for this version
-
2.3.029 Mar 2022Nothing published for this version
-
2.2.113 Jan 2022Nothing published for this version
-
2.2.003 Nov 2021Nothing published for this version
-
2.1.106 Oct 2021Nothing published for this version
-
2.1.019 Sep 2021Nothing published for this version
-
2.0.020 Jul 2021Nothing published for this version
-
1.13.023 Jun 2021Nothing published for this version
-
1.12.205 Jun 2021Nothing published for this version
-
1.12.120 Jan 2021Nothing published for this version
-
1.12.004 Oct 2020Nothing published for this version
-
1.11.025 Aug 2020Nothing published for this version
-
1.10.126 Jul 2020Nothing published for this version
-
1.10.029 May 2020Nothing published for this version
-
1.9.216 Jan 2020Nothing published for this version
-
1.9.116 Jan 2020Nothing published for this version
-
1.9.002 Dec 2019Nothing published for this version
-
1.8.322 Oct 2019Nothing published for this version
-
1.8.215 Sep 2019Nothing published for this version
-
1.8.128 Aug 2019Nothing published for this version
-
1.8.012 Aug 2019Nothing published for this version
-
1.7.107 Aug 2019Nothing published for this version
-
1.7.015 Jul 2019Nothing published for this version
-
1.6.715 Jul 2019Nothing published for this version
-
1.6.604 Jul 2019Nothing published for this version
-
1.6.502 Jul 2019Nothing published for this version
-
1.6.413 May 2019Nothing published for this version
-
1.6.305 Dec 2018Nothing published for this version
-
1.6.212 Nov 2018Nothing published for this version
-
1.6.111 Nov 2018Nothing published for this version
-
1.6.030 Oct 2018Nothing published for this version
-
1.5.403 Oct 2018Nothing published for this version
-
1.5.318 Jun 2018Nothing published for this version
-
1.5.212 Jun 2018Nothing published for this version
-
1.5.111 Mar 2018Nothing published for this version
-
1.5.024 Jan 2018Nothing published for this version
-
1.4.022 Jan 2018Nothing published for this version