PHPackages                             cognitus/numbertowords-esp - 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 &amp; Helpers](/categories/utility)
4. /
5. cognitus/numbertowords-esp

AbandonedArchivedLibrary[Utility &amp; Helpers](/categories/utility)

cognitus/numbertowords-esp
==========================

Convierte un número o cadena numerica a su valor correspondiente en palabras.

2.0.1(4y ago)03MITPHPPHP &gt;=8.0

Since Nov 20Pushed 4y agoCompare

[ Source](https://github.com/cognitus/numero-a-letras)[ Packagist](https://packagist.org/packages/cognitus/numbertowords-esp)[ Docs](https://github.com/cognitus/numero-a-letras)[ RSS](/packages/cognitus-numbertowords-esp/feed)WikiDiscussions master Synced today

READMEChangelog (2)Dependencies (1)Versions (6)Used By (0)

Numero A Letras
===============

[](#numero-a-letras)

Convierte un número o cadena numerica a su valor correspondiente en palabras.

Es un fork de xarenisoft/numbertowords-esp

Instalación
-----------

[](#instalación)

```
composer require cognitus/numbertowords-esp
```

Metodo:
-------

[](#metodo)

```
convertir(string $number,string $moneda = '',string $centimos = '',string $suffix='', int $flags = 0):string
```

Parametros
----------

[](#parametros)

#### number.

[](#number)

Numero o cadena numerica a convertir en palabras

#### moneda

[](#moneda)

moneda en texto que se agregara al final de la parte entera del valor numerico. Por ejemplo: PESOS

#### centimos

[](#centimos)

Si es indicado, es la parte centimos de la moneda, ejemplos son CENTAVOS, si no es especificado este valor o es cadena vacia se usa el formato ##/100

#### suffix

[](#suffix)

Sufijo , por defecto se agrega al final de la cadena solo cuando el formato es ##/100, se puede cambiar este comportamiento usando las banderas del ultimo parametro.

#### flags

[](#flags)

banderas para cambiar el comportamiento del metodo

Uso
---

[](#uso)

```
use Xarenisoft\NumberToWords\Esp\NumeroALetras;
$letras = NumeroALetras::convertir(12345);
//Tambien es posible recibir cadenas numericas

echo  NumeroALetras::convertir("121,311,321.21",'PESOS','CENTAVOS');
//CIENTO VENTIUN MILLONES TRESCIENTOS ONCE MIL TRESCIENTOS VENTIUN PESOS 21/100
echo NumeroALetras::convertir("$ 121,311,321.21",'PESOS','CENTAVOS');
//CIENTO VENTIUN MILLONES TRESCIENTOS ONCE MIL TRESCIENTOS VENTIUN PESOS 21/100
echo NumeroALetras::convertir("$-12131321.21",'PESOS','CENTAVOS');
//MENOS DOCE MILLONES CIENTO TREINTA Y UN MIL TRESCIENTOS VENTIUN PESOS CON VENTIUN CENTAVOS
```

Ademas de elegir los separadores y simbolo de moneda:

```
NumeroALetras::$currencySymbol='€';
NumeroALetras::$thousandSeparator='.';
NumeroALetras::$decimalSeparator=',';
echo NumeroALetras::convertir("12.345,67 €",'EUROS','','EUR');
//DOCE MIL TRESCIENTOS CUARENTA Y CINCO EUROS 67/100 EUR
```

Incluso haciendo uso de currencySymbol, se puede aceptar el siguiente formato:

```
NumeroALetras::$currencySymbol='MXN';
echo NumeroALetras::convertir("-12131321.21 MXN",'PESOS','CENTAVOS');
//MENOS DOCE MILLONES CIENTO TREINTA Y UN MIL TRESCIENTOS VENTIUN PESOS CON VENTIUN CENTAVOS
```

Configurando metodo con flags:

```
//forzando representar centimos cuando es cero:
NumeroALetras::convertir("121,311,321.0",'PESOS','','M.N.',NumeroALetras::FORZAR_CENTIMOS);
//CIENTO VENTIUN MILLONES TRESCIENTOS ONCE MIL TRESCIENTOS VENTIUN PESOS 00/100 M.N.

//forzando usar sufijo a pesar de que el formato es CENTAVOS
NumeroALetras::convertir("121,311,321.21",'PESOS','CENTAVOS','MXN',NumeroALetras::FORZAR_CENTIMOS|NumeroALetras::SUFFIX_SIEMPRE);
//CIENTO VENTIUN MILLONES TRESCIENTOS ONCE MIL TRESCIENTOS VENTIUN PESOS CON VENTIUN CENTAVOS MXN'
```

Excepciones
-----------

[](#excepciones)

La excepcion InvalidArgumentException es arrojada si el numero/cadena numerica excede los centenares de millon

Créditos
--------

[](#créditos)

Basado en la clase para PHP [AxiaCore/numero-a-letras](https://github.com/AxiaCore/numero-a-letras/blob/master/php/NumberToLetterConverter.class.php)

###  Health Score

28

—

LowBetter than 51% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 65% 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 ~222 days

Total

5

Last Release

1574d ago

Major Versions

1.1.1 → 2.0.02022-04-25

PHP version history (2 changes)1.0.0PHP &gt;=5.4

2.0.0PHP &gt;=8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/3610d3008cdde2df94fbe62fda533d4ce76e11447a8c4958b5f0d514a01ead6c?d=identicon)[cognitus](/maintainers/cognitus)

---

Top Contributors

[![DanNYSPD](https://avatars.githubusercontent.com/u/21212423?v=4)](https://github.com/DanNYSPD "DanNYSPD (26 commits)")[![cognitus](https://avatars.githubusercontent.com/u/2235718?v=4)](https://github.com/cognitus "cognitus (9 commits)")[![arielorozco85](https://avatars.githubusercontent.com/u/220616093?v=4)](https://github.com/arielorozco85 "arielorozco85 (3 commits)")[![arielcr](https://avatars.githubusercontent.com/u/989742?v=4)](https://github.com/arielcr "arielcr (1 commits)")[![manfredjb](https://avatars.githubusercontent.com/u/2416874?v=4)](https://github.com/manfredjb "manfredjb (1 commits)")

---

Tags

letrasconvertirnumero

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/cognitus-numbertowords-esp/health.svg)

```
[![Health](https://phpackages.com/badges/cognitus-numbertowords-esp/health.svg)](https://phpackages.com/packages/cognitus-numbertowords-esp)
```

###  Alternatives

[luecano/numero-a-letras

Convierte un número a letras.

78305.9k3](/packages/luecano-numero-a-letras)[wgenial/numeroporextenso

Converte numeral em valor por extenso.

4980.8k](/packages/wgenial-numeroporextenso)[webmil/text-language-detect

Detects the language of a given piece of text.

4491.1k](/packages/webmil-text-language-detect)[ynacorp/nova-swatches

A beautiful color picking field for Laravel Nova.

22324.3k1](/packages/ynacorp-nova-swatches)[pyaesone17/active-state

Active State Checker For Laravel Url

4765.1k2](/packages/pyaesone17-active-state)[mediawiki/semantic-scribunto

A Semantic Mediawiki extension to natively support the Scribunto extension

2972.8k](/packages/mediawiki-semantic-scribunto)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
