Project owner:Adam Peller

Contains data from the Common Locale Data Repository (CLDR). with associated utility classes


This data contains tables with culturally sensitive information for hundreds of languages and country variants, such as translations of days of the week, months of the year, patterns for formatting dates and numbers. This is used by dojo/date, dojo/number, and dojo/currency to produce localized output. The nls/ directory as provided in the standard download of Dojo contains a subset of the available locales; a complete set is available by running the ant script in util/buildscripts/cldr. See the section “Buildscripts” below for more information. It is therefore usually not necessary to hand-craft localized copies of this information. The CLDR project is responsible for the choices made in these files and has both a bug tracker and survey application on their website.

The data is transformed, as a pre-build step, from XML data to JSON-style JavaScript you see under the nls/ directory. This data is used by other modules in core Dojo such as, dojo.number and dojo.currency, which provides more friendly programmatic APIs. It usually is not necessary to use dojo.cldr.nls directly. Other modules available in the CLDR provide access to supplemental data:

Buildscripts in util/buildscripts/cldr

The scripts in this directory are responsible for generating the data tables in dojo/cldr/nls. Dojo provides a subset of this output in dojo/cldr/nls under source control, the rest must be generated by the developer using these scripts.

An optional list of locales may be specified as the ant property locales to limit the set of locales built. Currencies may also be specified via the ant property currencies. Both properties contain default lists in the build.xml ant script file.

To trigger generation of a full set of locale/currency resources: * change into the directory util/buildscripts/cldr * set ANT_HOME and JAVA_HOME * clear out the existing data by running “ant clean” * comment out the ant properties (see above, if they exist) locales and currencies * generate the new data by running “ant” * remove the newly created directory util/buildscripts/cldr/ldml/core

NOTE: it is currently necessary to perform a one-time installation of the Saxon XSLT processor in ~/.ant/lib due to classpath issues and workarounds. The ant task will do this for you. Also, ant version 1.6.5 is recommended. The build script does not properly resolve the XSLT catalog with newer versions of ant which makes the process take much longer. See ticket #7969.

Error in the documentation? Can’t find what you are looking for? Let us know!