//>>built 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; });