oza75 / Money-To-Words-Converter

💶 🈲A PHP library that converts any money value in digit [in any numeric system] to words in any language.

Money To Words Converter

A php library that converts any money value in digit in any language or numeric system to its words in any language

Installation

• Install this package via Composer.

composer require tnkemdilim/money-to-words-converter 

• Or edit your project's composer.json to require tnkemdilim/money-to-words-converter and then run composer update .

"require": {
    "tnkemdilim/money-to-words-converter": "*"
}

Usage

Basic usage

Note: You should have composer's autoloader included require 'vendor/autoload.php'

• Include MoneyToWordsCoverter namespace to your php file

<?php

  use MoneyToWords\MoneyToWordsConverter;

?>

• Instantiate the MoneyToWordsConverter object

//greek numeric system
$money = 748247284782;

//naira
$converter = new MoneyToWordsConverter($money, "naira");
echo ($converter->Convert());

Example

//chinese numeric system
$money = "八百七十二万七千八百二十四";

//converts money value to french sentence,  with yen as a currency
$converter = new MoneyToWordsConverter($money, "yens", "fr");
echo ($converter->Convert());

Find more numeric systems at Numeric systems

Set Converted Money Language

To set the language money should be translated into

$converter = new MoneyToWordsConverter($money, "yens", "fr"); //french
$converter = new MoneyToWordsConverter($money, "yens"); //english is default
$converter = new MoneyToWordsConverter($money, "yens", "es"); //spanish

Set a new language

  $converter->SetLanguage('en');
  $converter->SetLanguage('fr');
  $converter->SetLanguage('zh-TW');

Supported langauges

For more conversion types

Language Name	Code	Language Name	Code	Language Name	Code	Language Name	Code
Afrikaans	af	Irish	ga	Albanian	sq	Italian	it
Arabic	ar	Japanese	ja	Azerbaijani	az	Kannada	kn
Basque	eu	Korean	ko	Bengali	bn	Latin	la
Belarusian	be	Latvian	lv	Bulgarian	bg	Lithuanian	lt
Catalan	ca	Macedonian	mk	Chinese Simplified	zh-CN	Malay	ms
Chinese Traditional	zh-TW	Maltese	mt	Croatian	hr	Norwegian	no
Czech	cs	Persian	fa	Danish	da	Polish	pl
Dutch	nl	Portuguese	pt	English	en	Romanian	ro
Esperanto	eo	Russian	ru	Estonian	et	Serbian	sr
Filipino	tl	Slovak	sk	Finnish	fi	Slovenian	sl
French	fr	Spanish	es	Galician	gl	Swahili	sw
Georgian	ka	Swedish	sv	German	de	Tamil	ta
Greek	el	Telugu	te	Gujarati	gu	Thai	th
Haitian Creole	ht	Turkish	tr	Hebrew	iw	Ukrainian	uk
Hindi	hi	Urdu	ur	Hungarian	hu	Vietnamese	vi
Icelandic	is	Welsh	cy	Indonesian	id	Yiddish	yi

Change Currency

To change the currency of the money to convert

//dollar
$converter->ChangeCurrency("dollar");
echo ($converter->Convert());

//pounds
$converter->ChangeCurrency("pounds");
echo ($converter->Convert());

Set new currency value

To convert a new currency value

//greek numeric system 
$converter->SetMoneyValue(28747847);

//chinese numeric system
$converter->SetMoneyValue("八百七十二万七千八百二十四");