Index / Proyectos / Qulqi: Convierte números a letras en java

Qulqi: Convierte números a letras en java

Autor jc mouse lunes, noviembre 30, 2015

Hola 🙂 publicando de tiempo les dejo esta chiti librería java para convertir números a su equivalente literal.

La librería que bautice como “Qulqi.jar” que en quechua significa plata ~~(creo :/ )~~ si quieren el código se publico hace tiempo ya en java y c# si mal no recuerdo, el código actual de la librería esta modificado y arreglado según comentarios que dejaron tan amablemente :), el número máximo que soporta es de 999 999 999 999 (novecientos noventa y nueve mil millones novecientos noventa y nueve millones novecientos noventa y nueve mil novecientos noventa y nueve ) , se arreglo el error con el dígito 1, es decir 101: ciento un , ahora se lee como ciento uno, también el valor de 1000: mil se arreglo como “un mil” que es como se usa en algunos países en su facturación computarizada.

¿Como se instala?

Con su proyecto creado, en la parte de “Libraries” clic derecho -> “Add JAR/Folder…” y buscan donde descargaron la librería Qulqi.jar en su proyecto se agregara el jar de la siguiente forma:

Eso es todo 🙂

¿Como se usa?

Una vez agregada la librería en su proyecto, para poder usarlo se debe crear una instancia nueva.

import org.bolivia.qulqi.Qulqi;

public class NewMain {
    
    public static void main(String[] args) {
        //nueva instancia
        Qulqi qulqi = new Qulqi();
    }
}

La librería Qulqi.jar cuenta con cuatro métodos que son:

showMeTheMoney(String numero); método principal para convertir números a su equivalente en literal
setDecimalPartVisible(Boolean value) Permite habilitar o no la parte decimal del numero en cuestión, es decir si es FALSE ignorara la parte decimal. Por defecto esta habilitado.
setCoin(Coin moneda); Con este método podrás indicar la moneda que estés usando “Dolar Estadounidense – USD” , “Boliviano BOB”, “Euro EUR”, etc. Por defecto esta en “Boliviano BOB” oo/100 BOB 🙂
setFloating(FLOATING fltng); Con este método indicas si usas el punto (.) o la coma (,) como flotante. Por defecto esta en coma (,)

A continuación un ejemplo en código java

import org.bolivia.qulqi.Qulqi;
import org.bolivia.qulqi.Qulqi$COIN;
import org.bolivia.qulqi.Qulqi$FLOATING;

public class NewMain {
    
    public static void main(String[] args) {
        //nueva instancia
        Qulqi qulqi = new Qulqi();
        
        qulqi.setDecimalPartVisible(true);//parte decimal .00
        qulqi.setCoin(Qulqi$COIN.dolar_estadounidense);//moneda
        qulqi.setFloating(Qulqi$FLOATING.COMMA);//punto flotante (.) o (,)
        
        System.out.println( qulqi.showMeTheMoney("1825,25") );//formato valido
        
        System.out.println( qulqi.showMeTheMoney("1000000") );//formato valido
        
        System.out.println( qulqi.showMeTheMoney("888 555 333") );//formato valido
        
        System.out.println( qulqi.showMeTheMoney("888 555 333,123") );//formato valido
        
        System.out.println( qulqi.showMeTheMoney("888 555 333.123") );//formato valido se indico coma flotante
        
        qulqi.setFloating(Qulqi$FLOATING.POINT );//punto flotante (.) o (,)
        qulqi.setCoin(Qulqi$COIN.euro);//moneda
        
        System.out.println( qulqi.showMeTheMoney("888 555 333,123") );//formato NO valido se indico punto flotante
        
        System.out.println( qulqi.showMeTheMoney("0") );//formato valido
        
        System.out.println( qulqi.showMeTheMoney("") );//formato NO valido
        
        System.out.println( qulqi.showMeTheMoney("000007.99") );//formato valido
        
        qulqi.setDecimalPartVisible(false);//parte decimal .00
        System.out.println( qulqi.showMeTheMoney("999 999 999 999.99") );//formato valido valor maximo        
        
    }
}

y su salida en pantalla

un mil ochocientos veinticinco 25/100 USD
un millon 00/100 USD
ochocientos ochenta y ocho millones quinientos cincuenta y cinco mil trecientos treinta y tres 00/100 USD
ochocientos ochenta y ocho millones quinientos cincuenta y cinco mil trecientos treinta y tres 12/100 USD
<<invalido>>
<<invalido>>
cero 00/100 EUR
<<invalido>>
siete 99/100 EUR
novecientos noventa y nueve mil millones novecientos noventa y nueve millones novecientos noventa y nueve mil novecientos noventa y nueve

Eso es todo señores cualquier comentario es bienvenido

Descargate la librería desde este <<enlace pobre>>

Ya se que mezcle el español, quechua e ingles pero que le vamos hacer es como todo hay cosas que ni que 🙂

Enjoy!!!

También Te Podría Interesar

Crea tu JLabel con hipervinculo

Si queremos añadir un enlace web a una aplicación en java, podemos hacer uso de botones o etiquetas, incluso se puede añ...

JASYPT : Cifrado simplificado Java

Jasypt es una biblioteca java que permite agregar capacidades básicas de encriptación a proyectos con el mínimo esfuerzo...

Ejemplo de Pruebas Unitarias en Java

Una Prueba Unitaria, es una forma de comprobar que nuestro código, hace lo que se supone debe hacer; es decir, se asegur...

Autenticación de usuarios bajo el patrón MVC

MVC es un patrón de arquitectura de software que separa una aplicación en tres componentes lógicos principales. Estos s...

Generar reportes con origen de datos JSON

JSON es un formato de texto ligero para el intercambio de datos ampliamente usado en los Servicios Web. En este post uti...

Paso de parámetros entre dos Activity

En este tutorial veremos como pasar parámetros de un activity a otro activity, no hay mucho que decir así que manos a la...

3 comentarios en “Qulqi: Convierte números a letras en java”

Antonny k. dice:

30 noviembre, 2015 a las 23:28

Genial. Es una librería interesante. Si pudieras mostrarnos más librerías que conozcas y que puedan ser útiles, sería fantástico. 😀
marky b dice:

31 mayo, 2016 a las 17:03

Excelente aporte!!! sólo una cosa, como puedo quitar el “un mil” y pasarlo solamente a “mil” ? saludos desde México.
Rin dice:

21 abril, 2017 a las 4:37

Gracias ya mismo la voy a probar