You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
130 lines
5.0 KiB
130 lines
5.0 KiB
define([ |
|
"./_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; |
|
});
|
|
|