Dinero.js - librería para trabajar con valores monetarios

Dinero.js es una librería para trabajar con valores monetarios en JavaScript.

Dinero.js - librería para trabajar con valores monetarios

Características

  • API inmutable y encadenable.
  • Soporte para configuraciones globales.
  • Opciones de formato y redondeo ampliadas.
  • Soporte de Intl nativo (sin archivos de localización adicionales).
  • Conversión de moneda.

Descargar/instalar

Dinero.js proporciona construcciones para diferentes ambientes. También viene con versiones polifacéticas para navegadores antiguos.

La forma recomendada de instalación es a través de npm o Yarn:

npm install dinero.js --save
// or
yarn add dinero.js

También puedes descargar los archivos directamente o usar el CDN de jsDelivr.

Comienzo rápido

Dinero.js facilita la creación, el cálculo y el formato de los valores monetarios en JavaScript. Puede realizar operaciones aritméticas, analizarlas y formatearlas extensamente, comprobar una serie de cosas para que su propio proceso de desarrollo sea más fácil y seguro.

Nota: La biblioteca está disponible globalmente en los documentos para que puedas probarla directamente en la consola del navegador.

Para empezar, necesitas crear una nueva instancia de Dinero. Las cantidades se especifican en unidades monetarias menores (por ejemplo: "centavos" por el dólar). También puede especificar un código de moneda ISO 4217 (por defecto es USD).

Esto representa 50 euros:

const price = Dinero({ amount: 5000, currency: 'EUR' })

Puedes sumar o restar la cantidad que quieras, pasándole otra instancia de Dinero:

// devuelve un objeto Dinero con cantidad: 5500
price.add(Dinero({ amount: 500, currency: 'EUR' }))

// devuelve un objeto Dinero con cantidad: 4500
price.subtract(Dinero({ amount: 500, currency: 'EUR' }))

Dinero.js es inmutable, lo que significa que siempre tendrás una nueva instancia de Dinero cuando realices cualquier tipo de transformación en él. Tu instancia original permanecerá intacta.

price // todavía devuelve un objeto Dinero con la cantidad: 5000

Todas las operaciones de transformación devuelven una instancia de Dinero, así que puedes encadenar los métodos como quieras:

// devuelve un objeto Dinero con cantidad: 4000
Dinero({ amount: 500 })
  .add(Dinero({ amount: 500 }))
  .multiply(4)

Nota: debido a que las llamadas a los métodos se ejecutan de forma secuencial, la precedencia del operador matemático no se aplica. Cuando se ejecuta el código anterior, la suma se produce antes de la multiplicación, evaluando a 4000, mientras que 500 + 500 * 4 normalmente evaluaría a 2500. Si necesitas realizar una operación antes que otra, asegúrate de llamarla primero.

Referencias

Sitio web (Documentación): https://dinerojs.com/

Full Api Docs: https://dinerojs.com/module-dinero

¿Cuál es su reacción?

like
2
dislike
0
love
0
funny
0
angry
0
sad
0
wow
0