Skip to content

Releases: rmunate/SpellNumber

V 3.2.1

26 Aug 19:05
e5aedba
Compare
Choose a tag to compare

Convertir Números a Palabras en Laravel

Convierte fácilmente números a palabras en Laravel utilizando esta biblioteca, que aprovecha la extensión PHP INTL nativa para realizar conversiones sin esfuerzo. Con esta biblioteca, puedes convertir números a palabras en varios idiomas y también obtener el valor en formato de moneda según el idioma seleccionado. Los idiomas admitidos incluyen inglés, español, portugués, francés, italiano, rumano, hindi, polaco y persa (farsi).

⚙️ Esta biblioteca es compatible con las versiones de Laravel 8.0 y superiores ⚙️

Laravel 8.0+
Laravel 9.0+
Laravel 10.0+

SpellNumbers

📖 DOCUMENTATION IN ENGLISH 📖

Tabla de Contenidos

Instalación

Para instalar la dependencia a través de Composer, ejecuta el siguiente comando:

composer require rmunate/spell-number

Es importante asegurarse de que la extensión intl esté habilitada y cargada en el entorno.

Uso

Después de instalar la dependencia en tu proyecto, puedes comenzar a usarla con los siguientes ejemplos:

Conocer las Configuraciones Regionales Soportadas

Para obtener la lista actual de idiomas compatibles, ejecuta el siguiente comando:

SpellNumber::getAllLocales();
// array [▼
//     0 => "en" (Inglés)
//     1 => "es" (Español)
//     2 => "pt" (Portugués)
//     3 => "fr" (Francés)
//     4 => "it" (Italiano)
//     5 => "ro" (Rumano)
//     6 => "fa" (Farsi)
//     7 => "hi" (Hindi) 
//     8 => "pl" (Polaco)
// ]

Convertir Enteros a Palabras

Puedes convertir fácilmente números a palabras definiendo la configuración regional a aplicar. Si no defines una configuración regional, se aplicará "en" (inglés) de forma predeterminada.

SpellNumber::value(100)->locale('es')->toLetters();
// "Cien"

SpellNumber::value(100)->locale('fa')->toLetters();
// "صد"

SpellNumber::value(100)->locale('en')->toLetters();
// "One Hundred"

SpellNumber::value(100)->locale('hi')->toLetters();
// "एक सौ"

Convertir Números de Punto Flotante

Si es necesario, puedes pasar un número de punto flotante como argumento para convertirlo a palabras.

SpellNumber::value(123456789.12)->locale('es')->toLetters();
// "Ciento Veintitrés Millones Cuatrocientos Cincuenta Y Seis Mil Setecientos Ochenta Y Nueve Con Doce"

SpellNumber::value(123456789.12)->locale('hi')->toLetters();
// "बारह करोड़ चौंतीस लाख छप्पन हज़ार सात सौ नवासी और बारह"

Convertir a Formato de Moneda

Este método puede ser útil para facturas, recibos y escenarios similares. Obtiene el valor proporcionado en formato de moneda.

SpellNumber::value(100)->locale('es')->currency('pesos')->toMoney();
// "Cien Pesos"

SpellNumber::value(100.12)->locale('es')->currency('Pesos')->fraction('centavos')->toMoney();
// "Cien Pesos Con Doce Centavos"

SpellNumber::value(100)->locale('fa')->currency('تومان')->toMoney();
// "صد تومان"

SpellNumber::value(100.12)->locale('hi')->currency('रूपये')->fraction('पैसे')->toMoney();
// "एक सौ रूपये और बारह पैसे"

SpellNumber::value(100)->locale('hi')->currency('रूपये')->toMoney();
// "एक सौ रूपये"

SpellNumber::value(100.65)->locale('pl')->currency('złotych')->fraction('groszy')->toMoney;
// "Sto Złotych I Sześćdziesiąt Pięć Groszy"

Otros Métodos de Inicialización

Para admitir la versión 1.X, se mantienen los siguientes métodos de inicialización.

// Entero, este método requiere estrictamente un valor entero que se envíe como argumento.
SpellNumber::integer(100)->locale('es')->toLetters();

// Números de punto flotante, este método requiere estrictamente un valor de cadena como argumento.
SpellNumber::float('12345.23')->locale('es')->toLetters();

Creador

Contribuyentes

Licencia

Este proyecto se encuentra bajo la Licencia MIT.

🌟 ¡Apoya Mis Proyectos! 🚀

Realiza cualquier contribución que consideres adecuada; el código es completamente tuyo. Juntos, podemos hacer cosas increíbles y mejorar el mundo del desarrollo. Tu apoyo es invaluable. ✨

Si tienes ideas, suger

encias o simplemente quieres colaborar, ¡estamos abiertos a todo! Únete a nuestra comunidad y sé parte de nuestro camino hacia el éxito. 🌐👩‍💻👨‍💻

V3.2.0

22 Aug 14:02
e9a232d
Compare
Choose a tag to compare
SpellNumber::value(100.65)->locale('pl')->currency('złotych')->fraction('groszy')->toMoney;
// "Sto Złotych I Sześćdziesiąt Pięć Groszy"
  • Olsza (Polish Language)

V3.1.0

15 Aug 12:56
a44f7a9
Compare
Choose a tag to compare

Convert Numbers to Words in Laravel

Easily convert numbers to words in Laravel using this library, which leverages the native PHP INTL extension to perform conversion effortlessly. With this library, you can convert numbers to words in various languages and also obtain the value in currency format according to the selected language. Supported languages include English, Spanish, Portuguese, French, Italian, Romanian, Hindi and with the contribution of Siros Fakhri, Persian (Farsi) support has been added.

⚙️ This library is compatible with Laravel versions 8.0 and higher ⚙️

Laravel 8.0+
Laravel 9.0+
Laravel 10.0+

SpellNumbers

Table of Contents

Installation

To install the dependency via Composer, execute the following command:

composer require rmunate/spell-number

It's important to ensure that the intl extension is enabled and loaded in the environment.

Usage

After installing the dependency in your project, you can start using it with the following examples:

Knowing Supported Regional Configurations

To obtain the current list of languages with support, execute the following command:

SpellNumber::getAllLocales();
// array:7 [▼
//     0 => "en" (English)
//     1 => "es" (Spanish)
//     2 => "pt" (Portuguese)
//     3 => "fr" (French)
//     4 => "it" (Italian)
//     5 => "ro" (Romanian)
//     6 => "fa" (Farsi)
//     7 => "hi" (India) 
// ]

Convert Integers to Words

You can easily convert numbers to words by defining the regional configuration to apply. If you don't define a regional configuration, "en" (English) will be applied by default.

SpellNumber::value(100)->locale('es')->toLetters();
// "Cien"

SpellNumber::value(100)->locale('fa')->toLetters();
// "صد"

SpellNumber::value(100)->locale('en')->toLetters();
// "One Hundred"

SpellNumber::value(100)->locale('hi')->toLetters();
// "एक सौ"

Convert Floating-Point Numbers

If needed, you can pass a floating-point number as an argument to convert it to words.

SpellNumber::value(123456789.12)->locale('es')->toLetters();
// "Ciento Veintitrés Millones Cuatrocientos Cincuenta Y Seis Mil Setecientos Ochenta Y Nueve Con Doce"

SpellNumber::value(123456789.12)->locale('hi')->toLetters();
// "बारह करोड़ चौंतीस लाख छप्पन हज़ार सात सौ नवासी और बारह"

Convert to Currency Format

This method can be useful for invoices, receipts, and similar scenarios. Obtain the supplied value in currency format.

SpellNumber::value(100)->locale('es')->currency('pesos')->toMoney();
// "Cien Pesos"

SpellNumber::value(100.12)->locale('es')->currency('Pesos')->fraction('centavos')->toMoney();
// "Cien Pesos Con Doce Centavos"

SpellNumber::value(100)->locale('fa')->currency('تومان')->toMoney();
// "صد تومان"

SpellNumber::value(100.12)->locale('hi')->currency('रूपये')->fraction('पैसे')->toMoney();
// "एक सौ रूपये और बारह पैसे"

SpellNumber::value(100)->locale('hi')->currency('रूपये')->toMoney();
// "एक सौ रूपये"

Other Initializer Methods

To support version 1.X, the following initializer methods are maintained.

// Integer, this method strictly requires an integer value to be sent as an argument.
SpellNumber::integer(100)->locale('es')->toLetters();

// Floating-point numbers, this method strictly requires a string value as an argument.
SpellNumber::float('12345.23')->locale('es')->toLetters();

Creator

Contributors

License

This project is licensed under the MIT License.

V 3.0.0

13 Aug 16:22
f5cfc8e
Compare
Choose a tag to compare

Convert Numbers to Words in Laravel

Easily convert numbers to words in Laravel using this library, which leverages the native PHP INTL extension to perform conversion effortlessly. With this library, you can convert numbers to words in various languages and also obtain the value in currency format according to the selected language. Supported languages include English, Spanish, Portuguese, French, Italian, Romanian, and with the contribution of Siros Fakhri, Persian (Farsi) support has been added.

⚙️ This library is compatible with Laravel versions 8.0 and higher ⚙️

Laravel 8.0+
Laravel 9.0+
Laravel 10.0+

SpellNumbers

Table of Contents

Installation

To install the dependency via Composer, execute the following command:

composer require rmunate/spell-number

It's important to ensure that the intl extension is enabled and loaded in the environment.

Usage

After installing the dependency in your project, you can start using it with the following examples:

Knowing Supported Regional Configurations

To obtain the current list of languages with support, execute the following command:

SpellNumber::getAllLocales();
// array:7 [▼
//     0 => "en" (English)
//     1 => "es" (Spanish)
//     2 => "pt" (Portuguese)
//     3 => "fr" (French)
//     4 => "it" (Italian)
//     5 => "ro" (Romanian)
//     6 => "fa" (Farsi)
// ]

Convert Integers to Words

You can easily convert numbers to words by defining the regional configuration to apply. If you don't define a regional configuration, "en" (English) will be applied by default.

SpellNumber::value(100)->locale('es')->toLetters();
// "Cien"

SpellNumber::value(100)->locale('fa')->toLetters();
// "صد"

SpellNumber::value(100)->locale('en')->toLetters();
// "One Hundred"

Convert Floating-Point Numbers

If needed, you can pass a floating-point number as an argument to convert it to words.

SpellNumber::value(123456789.12)->locale('es')->toLetters();
// "Ciento Veintitrés Millones Cuatrocientos Cincuenta Y Seis Mil Setecientos Ochenta Y Nueve Con Doce"

Convert to Currency Format

This method can be useful for invoices, receipts, and similar scenarios. Obtain the supplied value in currency format.

SpellNumber::value(100)->locale('es')->currency('pesos')->toMoney();
// "Cien Pesos"

SpellNumber::value(100.12)->locale('es')->currency('Pesos')->fraction('centavos')->toMoney();
// "Cien Pesos Con Doce Centavos"

SpellNumber::value(100)->locale('fa')->currency('تومان')->toMoney();
// "صد تومان"

Other Initializer Methods

To support version 1.X, the following initializer methods are maintained.

// Integer, this method strictly requires an integer value to be sent as an argument.
SpellNumber::integer(100)->locale('es')->toLetters();

// Floating-point numbers, this method strictly requires a string value as an argument.
SpellNumber::float('12345.23')->locale('es')->toLetters();

Creator

Contributors

Siros Fakhri (Farsi Language)

License

This project is licensed under the MIT License.

V 2.0.0

31 Jul 18:48
0ab65d6
Compare
Choose a tag to compare

Convert Numbers to Words in Laravel

Easily convert numbers to words in Laravel using this library, which supports the native PHP INTL extension to perform the conversion seamlessly. This library allows you to convert numbers to words in multiple languages and also get the value in currency format based on the selected language. Supported languages include English, Spanish, Portuguese, French, Italian, and Romanian.

⚙️ This library is compatible with Laravel versions 8.0 and higher ⚙️

Laravel 8.0+
Laravel 9.0+
Laravel 10.0+

SpellNumbers

Table of Contents

Installation

To install the dependency via Composer, execute the following command:

composer require rmunate/spell-number

Make sure that the intl extension is enabled and loaded in your environment.

Usage

After installing the dependency in your project, you can start using it with the following examples:

// GET AVAILABLE LOCALES
SpellNumber::getAllLocales();
// array:6 [▼ //
//     0 => "en"
//     1 => "es"
//     2 => "pt"
//     3 => "fr"
//     4 => "it"
//     5 => "ro"
// ]

// CONVERT INTEGER TO WORDS
SpellNumber::value(100)->locale('en')->toLetters();
// "One Hundred"
SpellNumber::value(12300000)->locale('en')->toLetters();
// "Twelve Million Three Hundred Thousand"

// CONVERT FLOAT TO WORDS
SpellNumber::value(123456789.12)->locale('en')->toLetters();
// "One Hundred Twenty-Three Million Four Hundred Fifty-Six Thousand Seven Hundred Eighty-Nine Point Twelve"

// CONVERT INTEGER TO CURRENCY TEXT FORMAT
SpellNumber::value(100)->locale('en')->currency('dollars')->toMoney();
// "One Hundred Dollars"
SpellNumber::value(100.12)->locale('en')->currency('Dollars')->fraction('cents')->toMoney();
// "One Hundred Dollars and Twelve Cents"

// OTHER STARTING METHODS

// Integer, this method strictly requires an integer value as an argument.
SpellNumber::integer(100)->locale('en')->toLetters();

// Floats, this method strictly requires a string value as an argument.
SpellNumber::float('12345.23')->locale('en')->toLetters();

Creator

License

This project is under the MIT License.

V 1.0.0

30 Jul 22:17
Compare
Choose a tag to compare

Convertir números en Letras Laravel / PHP

Convierta de números a letras, de forma facil para implementar en Facturas, Remisiones u otros.

N|Solid

Convierta de manera sencilla números a letras (Solo en idioma Español), esta librería le puede ser útil para usar el valor en letras dentro de facturas, remisiones, etc. Puede retornar los valores en letras de solo números o tambien definiendo un tipo de moneda.

Instalación

Instalar a través de Composer

composer require rmunate/spell-number 1.0.x-dev

Generalidades

  • El número entero más grande aceptado es 999999999999999999
  • El decimal más grande aceptado es 99
  • El método ->current('PESO') asigna una S o ES al final en caso de que el numero sea mayor a 1, de no usarse, usará el valor PESO / PESOS
  • El método ->fraction('CENTAVO') asigna una S o ES al final en caso de que el numero sea mayor a 1, de no usarse, usará el valor CENTAVO / CENTAVOS
  • El metodo ::float('1000.10') solo recibe valores en formato String con separacion por coma o punto.

Métodos

LLAMADO METODOS CLASE DESCRIPCIÓN METODO
SpellNumber::integer(1000)->toLetters() Retorna el valor en letras "Capital Case".
SpellNumber::float('1000,10')->toLetters() Retornar los valores en letras relacionando los dos valores con el conector "coma".
SpellNumber::integer(1000)->toMoney() Retorna el valor en letras "Capital Case" como valor de moneda en letras.
SpellNumber::integer(1000)->currency('DOLAR')->toMoney() Retorna el valor en letras "Capital Case" como valor de "en este caso Dolares" en letras.
SpellNumber::integer(1000)->currency('DOLAR')->fraction('CENTAVO')->toMoney() Retorna el valor en letras "Capital Case" como valor de "en este caso Dolares y Centavos" en letras.
SpellNumber::float('1000.50')->toMoney() Retorna el valor en letras "Capital Case" como valor de moneda en letras.
SpellNumber::float('1000.50')->currency('DOLAR')->toMoney() Retorna el valor en letras "Capital Case" como valor de "en este caso Dolares" en letras.
SpellNumber::float('1000.50')->currency('DOLAR')->fraction('CENTAVO')->toMoney() Retorna el valor en letras "Capital Case" como valor de "en este caso Dolares y Centavos" en letras.

Ejemplo de Uso

SpellNumber::float('2000,50')->currency('Sol')->fraction('Centimo')->toMoney();
// "Dos Mil Soles Con Cincuenta Centimos"

SpellNumber::float('2000,50')->toMoney();
// "Dos Mil Pesos Con Cincuenta Centavos"

Desarrollador(es)

  • Ingeniero, Raúl Mauricio Uñate Castro
  • [email protected]
  • (Se reciben recomendaciones y mejoras al correo electronico.)

Open Source

  • MIT