@komandero/numeros-a-letras

Librería TypeScript sin dependencias que convierte números a su representación en letras (español). Soporta unidades y decimales con pluralización automática.

Instalación

npm install @komandero/numeros-a-letras

Uso

numberToWords

import { numberToWords } from '@komandero/numeros-a-letras';

numberToWords(100);
// => "CIEN"

numberToWords(538.18, { unit: 'EURO', decimal: 'CENTIMO' });
// => "QUINIENTOS TREINTA Y OCHO EUROS CON DIECIOCHO CENTIMOS"

numberToWords(54793.49, { unit: 'EURO', decimal: 'CENTIMO' });
// => "CINCUENTA Y CUATRO MIL SETECIENTOS NOVENTA Y TRES EUROS CON CUARENTA Y NUEVE CENTIMOS"

numberToWords(1.01, { unit: 'EURO', decimal: 'CENTIMO' });
// => "UN EURO CON UN CENTIMO"

numberToWords(21, { unit: 'EURO' });
// => "VEINTIÚN EUROS"

numberToWords(100, { uppercase: false });
// => "cien"

numberToEuros

Wrapper preconfigurado con EURO/CENTIMO:

import { numberToEuros } from '@komandero/numeros-a-letras';

numberToEuros(538.18);
// => "QUINIENTOS TREINTA Y OCHO EUROS CON DIECIOCHO CENTIMOS"

numberToEuros(1.01);
// => "UN EURO CON UN CENTIMO"

API

numberToWords(value: number, options?: NumberToWordsOptions): string

| Parámetro | Tipo | Default | Descripción | | ------------------- | --------- | ------- | --------------------------------------------------------------------------- | | value | number | — | Número a convertir (0 a 999,999,999,999). Soporta hasta 2 decimales. | | options.unit | string | "" | Unidad en singular (ej: "EURO"). Se pluraliza automáticamente con "S". | | options.decimal | string | "" | Nombre del decimal en singular (ej: "CENTIMO"). Se pluraliza con "S". | | options.uppercase | boolean | true | Si es true, el resultado se devuelve en mayúsculas. |

numberToEuros(value: number, options?: Omit<NumberToWordsOptions, 'unit' | 'decimal'>): string

Igual que numberToWords pero con unit: 'EURO' y decimal: 'CENTIMO' ya configurados.

Características

• Sin dependencias
• Tildes correctas (DIECISÉIS, VEINTIÚN, MILLÓN, etc.)
• Apócope automática: "veintiuno" -> "veintiún" antes de sustantivo, "uno" -> "un"
• Pluralización automática de unidades
• Soporte de 0 a 999,999,999,999
• Decimales de hasta 2 dígitos

Desarrollo

npm install
npm test
npm run build

Licencia

MIT