ttrss/lib/dojo/currency.js.uncompressed.js

131 lines
5.0 KiB
JavaScript
Raw Normal View History

2013-03-18 06:26:24 +00:00
define("dojo/currency", [
"./_base/array",
"./_base/lang",
/*===== "./_base/declare", =====*/
"./number",
"./i18n", "./i18n!./cldr/nls/currency",
"./cldr/monetary"
], function(darray, lang, /*===== declare, =====*/ dnumber, i18n, nlsCurrency, cldrMonetary){
// module:
// dojo/currency
var currency = {
// summary:
// localized formatting and parsing routines for currencies
// description:
// extends dojo.number to provide culturally-appropriate formatting of values
// in various world currencies, including use of a currency symbol. The currencies are specified
// by a three-letter international symbol in all uppercase, and support for the currencies is
// provided by the data in `dojo.cldr`. The scripts generating dojo.cldr specify which
// currency support is included. A fixed number of decimal places is determined based
// on the currency type and is not determined by the 'pattern' argument. The fractional
// portion is optional, by default, and variable length decimals are not supported.
};
lang.setObject("dojo.currency", currency);
currency._mixInDefaults = function(options){
options = options || {};
options.type = "currency";
// Get locale-dependent currency data, like the symbol
var bundle = i18n.getLocalization("dojo.cldr", "currency", options.locale) || {};
// Mixin locale-independent currency data, like # of places
var iso = options.currency;
var data = cldrMonetary.getData(iso);
darray.forEach(["displayName","symbol","group","decimal"], function(prop){
data[prop] = bundle[iso+"_"+prop];
});
data.fractional = [true, false];
// Mixin with provided options
return lang.mixin(data, options);
};
/*=====
currency.__FormatOptions = declare([dnumber.__FormatOptions], {
// type: String?
// Should not be set. Value is assumed to be "currency".
// symbol: String?
// localized currency symbol. The default will be looked up in table of supported currencies in `dojo.cldr`
// A [ISO4217](http://en.wikipedia.org/wiki/ISO_4217) currency code will be used if not found.
// currency: String?
// an [ISO4217](http://en.wikipedia.org/wiki/ISO_4217) currency code, a three letter sequence like "USD".
// For use with dojo.currency only.
// places: Number?
// number of decimal places to show. Default is defined based on which currency is used.
type: "",
symbol: "",
currency: "",
places: ""
});
=====*/
currency.format = function(/*Number*/ value, /*__FormatOptions?*/ options){
// summary:
// Format a Number as a currency, using locale-specific settings
//
// description:
// Create a string from a Number using a known, localized pattern.
// [Formatting patterns](http://www.unicode.org/reports/tr35/#Number_Elements)
// appropriate to the locale are chosen from the [CLDR](http://unicode.org/cldr)
// as well as the appropriate symbols and delimiters and number of decimal places.
//
// value:
// the number to be formatted.
return dnumber.format(value, currency._mixInDefaults(options));
};
currency.regexp = function(/*dnumber.__RegexpOptions?*/ options){
//
// summary:
// Builds the regular needed to parse a currency value
//
// description:
// Returns regular expression with positive and negative match, group and decimal separators
// Note: the options.places default, the number of decimal places to accept, is defined by the currency type.
return dnumber.regexp(currency._mixInDefaults(options)); // String
};
/*=====
var __ParseOptions = currency.__ParseOptions = declare(dnumber.__ParseOptions, {
// type: String?
// Should not be set. Value is assumed to be currency.
// currency: String?
// an [ISO4217](http://en.wikipedia.org/wiki/ISO_4217) currency code, a three letter sequence like "USD".
// For use with dojo.currency only.
// symbol: String?
// localized currency symbol. The default will be looked up in table of supported currencies in `dojo.cldr`
// A [ISO4217](http://en.wikipedia.org/wiki/ISO_4217) currency code will be used if not found.
// places: Number?
// fixed number of decimal places to accept. The default is determined based on which currency is used.
// fractional: Boolean|Array?
// Whether to include the fractional portion, where the number of decimal places are implied by the currency
// or explicit 'places' parameter. The value [true,false] makes the fractional portion optional.
// By default for currencies, it the fractional portion is optional.
});
=====*/
currency.parse = function(/*String*/ expression, /*__ParseOptions?*/ options){
//
// summary:
// Convert a properly formatted currency string to a primitive Number,
// using locale-specific settings.
// description:
// Create a Number from a string using a known, localized pattern.
// [Formatting patterns](http://www.unicode.org/reports/tr35/#Number_Format_Patterns)
// are chosen appropriate to the locale, as well as the appropriate symbols and delimiters
// and number of decimal places.
// expression:
// A string representation of a currency value
return dnumber.parse(expression, currency._mixInDefaults(options));
};
return currency;
});