lubosdz/number-to-words

Number to words conversion - locale specific.

Maintainers

Details

github.com/lubosdz/number-to-words

Source

Issues

Installs: 732

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 2

Forks: 1

Open Issues: 0

1.0.4 2024-02-04 22:46 UTC

Requires

  • php: >=5.5

BSD-3-Clause 3b0d247eee6cc69bebdf6ed3af8af99addd60b01

  • lubosdz@gmail.com

convert number to wordsprevod číslo na slovo

This package is auto-updated.

Last update: 2024-04-04 23:08:05 UTC

README

PHP utility for converting arbitrary float or integer number to words, mainly in English, Slovak and Czech. These have custom PHP implementation, which will fix INTL/ICU bugs and allows for output customization. Other languages are supported too, but only using INTL/ICU PHP extension, which might be buggy.

Installation

  • via composer:
$ composer require "lubosdz/number-to-words" : "~1.0.0"

Demo & repo

Usage

// use either factory ..
use lubosdz\numberToWords\NumberToWords;

// .. or language specific implementation
use lubosdz\numberToWords\NumberToWords_SK;
use lubosdz\numberToWords\NumberToWords_CZ;
use lubosdz\numberToWords\NumberToWords_EN;

// Slovensky / Slovak
NumberToWords::convert(123.45, 'sk'); // jednostodvadsaťtri celé štyridsaťpäť
NumberToWords_SK::convert(123.45); // jednostodvadsaťtri celé štyridsaťpäť
NumberToWords_SK::convertIntl(123.45); // jedna­sto dvasať­tri čiarka štyri päť (ICU returns "dvasať", bug)

// with decimals as a fraction - useful in accounting
NumberToWords::$decimalsAsFraction = true;
NumberToWords::convert(123.45, 'sk'); // jednostodvadsaťtri (45/100)

// Česky / Czech:
NumberToWords::convert(123.45, 'cz'); // allowed cz or cs, // sto dvacet tři čárka čtyřicet pět
NumberToWords_CZ::convert(123.45); // sto dvacet tři čárka čtyřicet pět
NumberToWords_CZ::convertIntl(123.45); // sto dvacet tři čárka čtyři pět

// English:
NumberToWords::convert(123.45); // lang code not needed since english is default
NumberToWords_EN::convert(123.45); // one hundred twenty-three point fourty-five
NumberToWords_EN::convertIntl(123.45); // one hundred twenty-three point four five

// really big number:
NumberToWords_EN::convert(987654321.123);
// nine hundred eighty-seven million, six hundred fifty-four thousand, three hundred twenty-one point one hundred twenty-three

NumberToWords_EN::convertIntl(987654321.123);
// nine hundred eighty-seven million six hundred fifty-four thousand three hundred twenty-one point one two three

// Russian:
NumberToWords::convert(123.45, 'ru'); // сто двадцать три целых сорок пять сотых

// German:
NumberToWords::convert(123.45, 'de'); // ein­hundert­drei­und­zwanzig Komma vier fünf

// French:
NumberToWords::convert(123.45, 'fr'); // cent vingt-trois virgule quatre cinq

Changelog

1.0.4 - 04.02.2024

  • Support decimals as a fraction
  • Fixed zeroes in decimal part on left side
  • added unit tests

1.0.3 - 02.07.2023

  • Fixed PHP 8.2 compatability

1.0.2 - 12.03.2021

  • extended support for any language via INTL/ICU extension

1.0.1 - 12.03.2021

  • added factory class NumberToWords::convert($num, $lang)

1.0.0 - 22.05.2020

  • initial release (SK, EN, CZ)