jmencoder/numero-a-letras

Convierte un número en letras en texto plano, formatos financieros, bancarios, contables.

v1.0.1 2021-11-16 02:08 UTC

This package is auto-updated.

Last update: 2025-05-16 10:59:15 UTC


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.