Conversor de numeros a letras en español

Clase con métodos que pueden llamarse para convertir un número entero a su equivalente en letras en español.

Descripción

En este paquete hay una clase Conversor, la cual posee los métodos necesarios para convertir números enteros a su representación en letras. Basado en la [escala numérica larga] (https://es.wikipedia.org/wiki/Escalas_num%C3%A9ricas_larga_y_corta) Limitaciones: Llega hasta el orden de los billones.

Instalación

La instalación se realiza vía [npm] (https://www.npmjs.com/). mediante el comando

npm install --save conversor-numero-a-letras-es-ar

Features

• Convertir números enteros (number o string) a su representación en letras (string).
• Convertir números del 1 al 12 (number o string) a su representación en letras del mes correspondiente (string).

Ejemplos

const conversor = require('conversor-numero-a-letras-es-ar');

let ClaseConversor = conversor.conversorNumerosALetras;
let miConversor = new ClaseConversor();

var a = miConversor.convertToText(27);
var b = miConversor.convertToText('27');

console.log(a); // imprime "veintisiete"
console.log(b); // imprime "veintisiete"


var c = miConversor.convertToText(2019);

console.log(c); // imprime "dos mil diecinueve"


function getFechaActualEnTexto() {
    var today = new Date();

    var dd = String(today.getDate()).padStart(2, '0');
    var mm = String(today.getMonth() + 1).padStart(2, '0'); //Enero es 0!
    var yyyy = today.getFullYear();
    
    dd = miConversor.convertToText(String(dd));
    mm = miConversor.convertirNroMesAtexto(String(mm));
    yyyy = miConversor.convertToText(String(yyyy));

    return `${dd} de ${mm} de ${yyyy}`;
}
console.log(getFechaActualEnTexto()) //Siendo 10/11/2019(dd/mm/aaaa) imprime "diez de Noviembre de dos mil diecinueve"

Guia

Luego de instalar el paquete como dependencia, para utilizarlo debe importar el módulo dentro del archivo .js donde lo quiera utilizar con nodejs.

const <conversor> = require('conversor-numero-a-letras-es-ar');

Donde es el objeto que posee el módulo. Para acceder a la clase del conversor debe referenciarlo a una variable.

const <ClaseConversor> = <Conversor>.conversorNumerosALetras;

Luego puede crear una instancia de la clase.

const <miConversor> = new <ClaseConversor>();

Ahora puede utilizar los métodos de la clase, los cuales son:

• convertToText(number) Convierte un número a su nombre en texto, el argumento puede ser de tipo number o string. Devuelve un string.
• convertirNroMesAtexto(number) Convierte un número de mes a su nombre en texto, el argumento puede ser de tipo number o string. Devuelve un string.
• deleteZerosLeft(number) Elimina los ceros a la izquierda en un número, acepta sólo strings como argumento.
• validateNumber(number) Valida que el argumento sea un número y si es una cadena que no esté vacía`, que no tenga punto decimal y que no sea negativo.