The ECMAScript Internationalization API

By -
The ECMAScript Internationalization API is a standard JavaScript API that helps with tasks related to internationalization: collation, number formatting, date and time formatting. This blog post gives a brief overview and points to more reading material.



The ECMAScript Internationalization API, edition 1



The first edition of the API provides the following services:

  • Collation. supports two scenarios: sorting a set of strings and searching within a set of strings. Collation is parameterized by locale and aware of Unicode.

  • Number formatting. Parameters include:

    • Style of formatting: decimal, currency (which one and how to refer to it, is determined by other parameters), percent.

    • Locale (directly specified or best fit, searched for via a matcher object)

    • Numbering system (Western digits, Arabic digits, Thai digits, etc.)

    • Precision: number of integer digits, fraction digits, significant digits

    • Grouping separators on or off



  • Date and time formatting. Parameters include:

    • what information to format and in which style (short, long, numeric, etc.)

    • a locale

    • a time zone




Most of the functionality is accessed via an object in the global variable Intl, but the API also augments the following methods:

  • String.prototype.localeCompare

  • Number.prototype.toLocaleString

  • Date.prototype.toLocaleString

  • Date.prototype.toLocaleDateString

  • Date.prototype.toLocaleTimeString



What kind of standard is it?



The number of the standard “ECMAScript Internationalization API” (EIA) is ECMA-402. It is hosted by Ecma International, the same association that also hosts EMCA-262, the ECMAScript language specification. Both standards are maintained by TC39 [1]. Therefore, EIA is as close to language as you can get without being part of ECMA-262. The API has been designed to work with both ECMAScript 5 and ECMAScript 6.


A set of conformance tests complements the standard and ensures that the various implementations of the API are compatible (ECMA-262 has a similar test suite).

When can I use it?



Google Chrome and Internet Explorer 11 support the API, support in Firefox Nightly must be switched on via a flag. David Storey has created a detailed compatibility table (which browsers support which locales etc.).

Upcoming: edition 2



Work on edition 2 of the API is ongoing. The Internationalization API wiki gives first clues as to what features will be included in that edition. Three examples from the wiki page with strawman proposals:

  • Message formatting: format a string with placeholders, including plural and gender support.

  • Parsing numbers.

  • Text segmentation: break text into grapheme clusters, words, lines, and sentences.



Edition 2 will be based on ECMAScript 6, it will not be compatible with ECMAScript 5, any more.

Further reading



The specification of the ECMAScript Internationalization API is edited by Norbert Lindenberg. It is available in the formats PDF, HTML and EPUB.
Additionally, there are several comprehensive introductory articles:


Reference




  1. A JavaScript glossary: ECMAScript, TC39, etc.

Comments

Post a Comment

Popular posts from this blog

Steve Lopez and the Importance of Newspapers

By -
Image
It has been one year since I cancelled my subscriptions to The New York Times and the Los Angeles Times . In that time, I continued to read both publications online. My assessment of this experiment is that reading newspapers and journalism online is vastly inferior to the hard copy thrown on my porch each morning. So I restarted my subscription to the Los Angeles Times and I have made it a point to buy The New York Times as often as I pass one of those coin boxes or my local news stand. The catalyst for this re-evaluation resulted from catching the film, The Soloist on cable last week. I liked the movie, although the scenes I found most interesting were the ones that showed columnist Steve Lopez at work. I realized the book was sitting in my “to-read” stack, so I pulled it and began reading. The book, as I expected, is better than the film. Lopez clearly addresses the revolution occurring in journalism, and worries about his future with the paper even as he researches and writes...
Keep reading

Ideas for fixing unconnected computing

By -
I traveled quite a bit recently and got exposed to a negative aspect of current technology: Things work well if you have a solid internet connection with no traffic limits and are plugged into a power outlet. Otherwise, things do not work well at all. This blog post describes the problems that arise and suggests solutions. Managing data traffic Cell phones are quite good at conserving traffic, laptops much less so. This becomes a problem when your laptop has a mobile connection (e.g., via tethering or in a hotel with data caps). I once accidentally started iTunes in such a situation and immediately used up my daily allowance of traffic. Similarly, mobile email is frugal with traffic (only the current folder is updated, attachments are only downloaded on demand, etc.), desktop email is usually not. How can this be handled better? I’d like to see three traffic modes for all operating systems: “full”, “restricted”, “minimal”: In full traffic mode , all data transfers are allowed and happe...
Keep reading

Omar to kill me

By -
Image
  The sentence “ Omar m’a tuer ” is unintelligible French, as if it had been written by an illiterate person. At first sight, Mme Ghislaine Marchal —the author of those words in blood—seems to be saying that she had been killed by Omar in her villa at Mougins (Alpes-Maritimes). But why would that dying French lady have used such poor grammar? On that flimsy evidence, in 1991, the Moroccan gardener Omar Raddad was condemned and jailed. But he persisted non-stop upon his innocence. In 1998, he was liberated, and now lives in Morocco. A recent analysis of DNA specimens from the scene of the crime provides new facts. Four males, none of whom was Omar Raddad, have left traces of their presence. Will the real murderer be identified at last?
Keep reading