Releases: rmunate/SpellNumber
V 3.2.1
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 ⚙️
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
- 🇨🇴 Raúl Mauricio Uñate Castro
- Correo Electrónico: [email protected]
Contribuyentes
- Siros Fakhri (Idioma Farsi)
- Ashok Devatwal (Idioma Hindi)
- Olsza (Idioma Polaco)
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
V3.1.0
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 ⚙️
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
- 🇨🇴 Raúl Mauricio Uñate Castro
- Email: [email protected]
Contributors
- Siros Fakhri (Farsi Language)
- Ashok Devatwal (Hindi Language)
License
This project is licensed under the MIT License.
V 3.0.0
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 ⚙️
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
- 🇨🇴 Raúl Mauricio Uñate Castro
- Email: [email protected]
Contributors
Siros Fakhri (Farsi Language)
License
This project is licensed under the MIT License.
V 2.0.0
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 ⚙️
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
- 🇨🇴 Raúl Mauricio Uñate Castro
- Email: [email protected]
License
This project is under the MIT License.
V 1.0.0
Convertir números en Letras Laravel / PHP
Convierta de números a letras, de forma facil para implementar en Facturas, Remisiones u otros.
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