PHPackages luecano/numero-a-letras - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. luecano/numero-a-letras ActiveLibrary[Utility & Helpers](/categories/utility) luecano/numero-a-letras ======================= Convierte un número a letras. v4.0.1(1y ago)78256.1k—0.3%31[2 issues](https://github.com/lecano/php-numero-a-letras/issues)2MITPHPPHP ^8.2CI passing Since Nov 5Pushed 1y ago4 watchersCompare [ Source](https://github.com/lecano/php-numero-a-letras)[ Packagist](https://packagist.org/packages/luecano/numero-a-letras)[ Docs](https://github.com/luecano/numero-a-letras)[ GitHub Sponsors](https://github.com/lecano)[ RSS](/packages/luecano-numero-a-letras/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (1)Versions (15)Used By (2) Número a Letras PHP ------------------- [](#número-a-letras-php) [![tests](https://github.com/luecano/numero-a-letras/workflows/tests/badge.svg)](https://github.com/luecano/numero-a-letras/actions)[![StyleCI](https://camo.githubusercontent.com/7c8eb8f00ccff18bc6a9bd9f1d93fe237ce0cc899c2de53b51760e2f9d4bf558/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3135363235383830302f736869656c643f7374796c653d666c6174266272616e63683d6d6173746572)](https://github.styleci.io/repos/156258800?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/82cafb143fdd8897a8ef589b1f1be97254f296630d37286f35f81522c86757a9/68747470733a2f2f706f7365722e707567782e6f72672f6c756563616e6f2f6e756d65726f2d612d6c65747261732f762f737461626c65)](https://packagist.org/packages/luecano/numero-a-letras)[![Total Downloads](https://camo.githubusercontent.com/8538a72e2fcf3eae01b08c1bc9995ea6a45505624da77c016b4819ccf7360e5e/68747470733a2f2f706f7365722e707567782e6f72672f6c756563616e6f2f6e756d65726f2d612d6c65747261732f646f776e6c6f616473)](//packagist.org/packages/luecano/numero-a-letras)[![License](https://camo.githubusercontent.com/5067de194d14dbfe6261d056b7440f1d3dc61f4ff8982ed6ef597fbb763c102d/68747470733a2f2f706f7365722e707567782e6f72672f6c756563616e6f2f6e756d65726f2d612d6c65747261732f6c6963656e7365)](https://packagist.org/packages/luecano/numero-a-letras) [![Logo](https://repository-images.githubusercontent.com/156258800/be96b2b4-80bd-40ef-91e9-a2cddf94df51)](https://repository-images.githubusercontent.com/156258800/be96b2b4-80bd-40ef-91e9-a2cddf94df51) Librería PHP para convertir un número a letras, palabras o texto. Introducción ------------ [](#introducción) `php-numero-a-letras` es una librería PHP que permite convertir números a su representación en palabras. Es útil para generar textos como "mil doscientos treinta y cuatro" a partir del número 1234. Instalación ----------- [](#instalación) ### PHP ^8.2: [](#php-82) ``` composer require luecano/numero-a-letras "^4.0" ``` PHP 7.2 a 8.1: ``` composer require luecano/numero-a-letras "^3.0" ``` PHP 5.6 a 7.1: ``` composer require luecano/numero-a-letras "^2.0" ``` Uso --- [](#uso) Agregar referencia a librería. ``` require 'vendor/autoload.php'; // Línea no necesaria si se usa frameworks como Laravel use Luecano\NumeroALetras\NumeroALetras; ``` ### Convertir un número a letras o palabras [](#convertir-un-número-a-letras-o-palabras) ``` $formatter = new NumeroALetras(); echo $formatter->toWords($number, $decimals); ``` Parámetros: - int|float `$number` (requerido) El número a convertir. - int `$decimals` (opcional) Establece el número de decimales, valor por defecto es 2. ### Convertir un número a letras en formato moneda [](#convertir-un-número-a-letras-en-formato-moneda) ``` $formatter = new NumeroALetras(); echo $formatter->toMoney($number, $decimals, $currency, $cents); ``` Parámetros: - int|float `$number` (requerido) El número a convertir. - int `$decimals` (opcional) Establece el número de decimales, valor por defecto es 2. - string `$currency` (opcional) Establece el nombre o código de moneda para la parte entera, valor por defecto es string vacío. - string `$cents` (opcional) Establece el nombre o código para la parte decimal, valor por defecto es string vacío. ### Convertir un número a letras en formato libre [](#convertir-un-número-a-letras-en-formato-libre) ``` $formatter = new NumeroALetras(); echo $formatter->toString($number, $decimals, $whole_str, $decimal_str); ``` Parámetros: - int|float `$number` (requerido) El número a convertir. - int `$decimals` (opcional) Establece el número de decimales, valor por defecto es 2. - string `$whole_str` (opcional) Establece el texto para la parte entera, valor por defecto es string vacío. - string `$decimal_str` (opcional) Establece el texto para la parte decimal, valor por defecto es string vacío. ### Convertir un número a letras en formato de facturación electrónica SUNAT [](#convertir-un-número-a-letras-en-formato-de-facturación-electrónica-sunat) ``` $formatter = new NumeroALetras(); echo $formatter->toInvoice($number, $decimals, $currency); ``` Parámetros: - int|float `$number` (requerido) El número a convertir. - int `$decimals` (opcional) Establece el número de decimales, valor por defecto es 2. - string `$currency` (opcional) Establece el nombre o código de moneda, valor por defecto es string vacío. ### Apócope de uno [](#apócope-de-uno) Para cambiar la palabra 'UNO' por 'UN' hacer lo siguiente: ``` $formatter = new NumeroALetras(); $formatter->apocope = true; ``` ### Conector [](#conector) Para cambiar la palabra 'CON' por otra de su preferencia hacer lo siguiente: ``` $formatter = new NumeroALetras(); $formatter->conector = 'Y'; ``` Ejemplos de uso --------------- [](#ejemplos-de-uso) ``` $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 ``` Contribuciones -------------- [](#contribuciones) Se aceptan contribuciones siguiendo el [GitHub Flow](https://guides.github.com/introduction/flow). Crea una rama, agrega commits y abre un pull request. Licencia -------- [](#licencia) Software de código abierto con licencia [MIT license](LICENSE). ### Health Score 53 — FairBetter than 97% of packages Maintenance41 Moderate activity, may be stable Popularity51 Moderate usage in the ecosystem Community23 Small or concentrated contributor base Maturity81 Battle-tested with a long release history Bus Factor1 Top contributor holds 95.8% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~189 days Recently: every ~403 days Total 13 Last Release 474d ago Major Versions v1.4.1 → v2.0.02020-04-23 v2.2.0 → v3.0.02021-03-05 v3.0.0 → v4.0.02024-10-05 PHP version history (4 changes)v1.0.0PHP ^5.5 || ^7.0 v1.4.0PHP >=5.6 v3.0.0PHP ^7.2|^8.0 v4.0.0PHP ^8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/571ecf3c2e44d415b8b2e8a5a5c8c724a7bd898f7a6ca717668d51f13b543be7?d=identicon)[lecano](/maintainers/lecano) --- Top Contributors [![lecano](https://avatars.githubusercontent.com/u/5108807?v=4)](https://github.com/lecano "lecano (115 commits)")[![pedroxido](https://avatars.githubusercontent.com/u/5884820?v=4)](https://github.com/pedroxido "pedroxido (3 commits)")[![FuriosoJack](https://avatars.githubusercontent.com/u/26976637?v=4)](https://github.com/FuriosoJack "FuriosoJack (1 commits)")[![StyleCIBot](https://avatars.githubusercontent.com/u/11048387?v=4)](https://github.com/StyleCIBot "StyleCIBot (1 commits)") --- Tags convertirletrasnumerophptextoletrasfacturacionconvertirnumerosunat ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/luecano-numero-a-letras/health.svg) ``` [![Health](https://phpackages.com/badges/luecano-numero-a-letras/health.svg)](https://phpackages.com/packages/luecano-numero-a-letras) ``` ### Alternatives [greenter/greenter Facturacion Electrónica SUNAT en Perú 31530.2k1](/packages/greenter-greenter)[wgenial/numeroporextenso Converte numeral em valor por extenso. 4666.9k](/packages/wgenial-numeroporextenso)[codersfree/laravel-greenter Laravel package for Greenter 261.4k](/packages/codersfree-laravel-greenter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)