README

Librería PHP para convertir un número en letras.

Requerimientos

PHP 7.2 o superior.

Instalar

Instalar usando Composer

composer require jmencoder/numero-a-letras

Uso

Agregar referencia a librería.

require 'vendor/autoload.php';
use jmencoder\NumerosALetras\NumerosALetras;

Convertir un número en letras

$converter = new NumerosALetras();
echo $converter->toWords($number, $decimals,$text);

Parámetros:

• int|float $number (requerido) El número a convertir.

• int $decimals (opcional) Establece la cantidad de decimales, valor por defecto se establece 2.

• string $text (opcional) Establece el texto que se presentara concatenado al valor por defecto se establece vacia.

Convertir un número a letras en formato de facturación fiscal financiera

$converter = new NumerosALetras();
echo $converter->toInvoice($number, $decimals, $currency);

Parámetros:

• int|float $number (requerido) El número a convertir.

• int $decimals (opcional) Establece la cantidad de decimales, valor por defecto se establece 2.

• string $currency (opcional) Establece el texto que se presentara como moneda por defecto se establece vacia.

Suprimir el uno

Para cambiar la palabra 'UNO' por 'UN' hacer lo siguiente:

$converter = new NumerosALetras();
$converter->suppress = true;

Concatenado

Para cambiar la palabra 'CON' por otra según sea necesario hacer lo siguiente:

$converter = new NumerosALetras();
$converter->anexar = 'Y';

Ejemplos de uso

$converter = new NumerosALetras();
echo $converter->toWords(1500);

//MIL QUINIENTOS

$converter = new NumerosALetras();
echo $converter->toWords(101,0,"MESES");

//CIENTO UNO MESES

$converter = new NumerosALetras();
$converter->suppress = true;
echo $converter->toWords(101,0,"MESES");

//CIENTO UN MESES

$converter = new NumerosALetras();
echo $converter->toInvoice(1200.50, 2, 'dolares');

//MIL DOSCIENTOS DOLARES CON 50/100

$converter = new NumerosALetras();
$converter->currencyPosition = 'after';
echo $converter->toInvoice(1200.50, 2, 'dolares');

//MIL DOSCIENTOS CON 50/100 DOLARES

$converter = new NumerosALetras();
$converter->currencyPosition = 'after';
$converter->anexar = 'Y';
echo $converter->toInvoice(1200.50, 2, 'dolares');

//MIL DOSCIENTOS Y 50/100 DOLARES

Licencia

Software de código abierto con licencia MIT license.