money.js is a tiny (1kb) javascript currency conversion library, for web & nodeJS
CSS JavaScript
Switch branches/tags
Clone or download
Joss Crowcroft
Joss Crowcroft package.json
Latest commit fcdfada Jul 16, 2014
Permalink
Failed to load latest commit information.
demo-resources v0.2 Jul 15, 2014
.gitignore first release, off we trot. Oct 11, 2011
.npmignore Updated info for npm Oct 14, 2011
index.html v0.2 Jul 15, 2014
license v0.2 Jul 15, 2014
money.js v0.2 Jul 15, 2014
money.min.js v0.2 Jul 15, 2014
package.json package.json Jul 16, 2014
readme.md package.json Jul 16, 2014

readme.md

money.js / fx()

Simple and tiny JavaScript library for realtime currency conversion and exchange rate calculation, from any currency, to any currency.

money.js is lightweight, has no dependencies, and works great client-side or server-side. Use standalone or as a nodeJS/npm and AMD/requireJS module.

Designed for seamless integration with the Open Exchange Rates API, but can be integrated with any source of currency data or with static/cached/approximate exchange rates.

Visit the plugin homepage for demos and documentation: http://openexchangerates.github.io/money.js/

Quick Examples:

// Simple syntax:
fx.convert(1000, {from: "GBP", to: "HKD"});

// Method chaining:
fx(1.99).from("USD").to("AED");

// Basic parsing:
fx("$1.99 HKD").to("EUR");

// Default parameters:
fx(5318008).convert();

// Supports nodeJS / AMD:
var fx = require('money');
require(["money"], function(fx) { /* ... */ });

Changelog

0.2

  • Now maintained by Open Exchange Rates
  • Improved documentation

0.1.3 - Fixed typo in nodeJS module definition

0.1.2 - Strengthened up module definition similar to accounting.js

0.1.1 - Added fallback when base rate is not in rates object (e.g. "USD": 1) to avoid errors

0.1.0 - Added license; bumped version

0.0.2

  • Adds basic parsing to fx(), so that you can pass a formatted string, like so: fx("$1.99 HKD").to("GBP")
  • Some cleanup and improved comments and docs

0.0.1 - First release