diff options
Diffstat (limited to 'lib/dojo/currency.js.uncompressed.js')
| -rw-r--r-- | lib/dojo/currency.js.uncompressed.js | 132 |
1 files changed, 132 insertions, 0 deletions
diff --git a/lib/dojo/currency.js.uncompressed.js b/lib/dojo/currency.js.uncompressed.js new file mode 100644 index 000000000..7b17f1fb2 --- /dev/null +++ b/lib/dojo/currency.js.uncompressed.js @@ -0,0 +1,132 @@ +define("dojo/currency", ["./_base/kernel", "./_base/lang", "./_base/array", "./number", "./i18n", "./i18n!./cldr/nls/currency", "./cldr/monetary"], function(dojo, lang, darray, dnumber, i18n, nlsCurrency, cldrMonetary) { + // module: + // dojo/currency + // summary: + // TODOC + +lang.getObject("currency", true, dojo); + +/*===== +dojo.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. +} +=====*/ + +dojo.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); +}; + +/*===== +dojo.declare("dojo.currency.__FormatOptions", [dojo.number.__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: "" +}); +=====*/ + +dojo.currency.format = function(/*Number*/value, /*dojo.currency.__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, dojo.currency._mixInDefaults(options)); +}; + +dojo.currency.regexp = function(/*dojo.number.__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(dojo.currency._mixInDefaults(options)); // String +}; + +/*===== +dojo.declare("dojo.currency.__ParseOptions", [dojo.number.__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. + type: "", + currency: "", + symbol: "", + places: "", + fractional: "" +}); +=====*/ + +dojo.currency.parse = function(/*String*/expression, /*dojo.currency.__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, dojo.currency._mixInDefaults(options)); +}; + +return dojo.currency; +}); |