README

PHP库，用于将数字转换为字母、单词或文本。

安装

PHP 7.2+ 和 8.0+

composer require luecano/numero-a-letras "^3.0"

PHP 5.6, 7.0 和 7.1

composer require luecano/numero-a-letras "^2.0"

用法

添加库引用。

require 'vendor/autoload.php';
use Luecano\NumeroALetras\NumeroALetras;

将数字转换为字母或单词

$formatter = new NumeroALetras();
echo $formatter->toWords($number, $decimals);

参数

• int|float $number (必需) 要转换的数字。

• int $decimals (可选) 设置小数位数，默认值是 2。

将数字转换为字母的货币格式

$formatter = new NumeroALetras();
echo $formatter->toMoney($number, $decimals, $currency, $cents);

参数

• int|float $number (必需) 要转换的数字。

• int $decimals (可选) 设置小数位数，默认值是 2。

• string $currency (可选) 设置整数部分的货币名称或代码，默认值为空字符串。

• string $cents (可选) 设置小数部分的名称或代码，默认值为空字符串。

将数字转换为字母的自由格式

$formatter = new NumeroALetras();
echo $formatter->toString($number, $decimals, $whole_str, $decimal_str);

参数

• int|float $number (必需) 要转换的数字。

• int $decimals (可选) 设置小数位数，默认值是 2。

• string $whole_str (可选) 设置整数部分的文本，默认值为空字符串。

• string $decimal_str (可选) 设置小数部分的文本，默认值为空字符串。

将数字转换为字母的SUNAT电子发票格式

$formatter = new NumeroALetras();
echo $formatter->toInvoice($number, $decimals, $currency);

参数

• int|float $number (必需) 要转换的数字。

• int $decimals (可选) 设置小数位数，默认值是 2。

• string $currency (可选) 设置货币的名称或代码，默认值为空字符串。

单数省略

要将'UNO'替换为'UN'，请执行以下操作

$formatter = new NumeroALetras();
$formatter->apocope = true;

连接词

要将'CON'替换为您喜欢的其他词，请执行以下操作

$formatter = new NumeroALetras();
$formatter->conector = 'Y';

使用示例

$formatter = new NumeroALetras();
echo $formatter->toWords(1100);

//MIL CIEN

$formatter = new NumeroALetras();
$formatter->apocope = true;
echo $formatter->toWords(101) . ' AÑOS';

//CIENTO UN AÑOS

$formatter = new NumeroALetras();
echo $formatter->toMoney(2500.90, 2, 'DÓLARES', 'CENTAVOS');

//DOS MIL QUINIENTOS DÓLARES CON NOVENTA CENTAVOS

$formatter = new NumeroALetras();
echo $formatter->toMoney(10.10, 2, 'SOLES', 'CENTIMOS');

//DIEZ SOLES CON DIEZ CENTIMOS

$formatter = new NumeroALetras();
$formatter->conector = 'Y';
echo $formatter->toMoney(11.10, 2, 'pesos', 'centavos');

//ONCE PESOS Y DIEZ CENTAVOS

$formatter = new NumeroALetras();
echo $formatter->toInvoice(1700.50, 2, 'soles');

//MIL SETECIENTOS CON 50/100 SOLES

$formatter = new NumeroALetras();
echo $formatter->toString(5.2, 1, 'años', 'meses');

//CINCO AÑOS CON DOS MESES

贡献

接受贡献，请遵循 GitHub Flow。创建一个分支，添加提交并打开一个pull request。

许可证

开源软件，使用MIT许可证。