Add date formatting and parsing code.

lib/i18n/intl.dart

+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
 /**
- * Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
- * for details. All rights reserved. Use of this source code is governed by a
- * BSD-style license that can be found in the LICENSE file.
- *
  * Internationalization object providing access to message formatting objects,
  * date formatting, parsing, bidirectional text relative to a specific locale.
  */
 
 #library('Intl');
 
 #import('intl_message.dart');
 #import('date_format.dart');
 
 class Intl {
-
   /**
    * String indicating the locale code with which the message is to be
    * formatted (such as en-CA).
    */
   String _locale;
 
   IntlMessage intlMsg;
 
-  DateFormat date;
+  /**
+   * Return a new date format using the specified [pattern] or with no
+   * pattern if it was omitted. In the second case we assume that pattern
+   * will be set later, otherwise the format is not useful.

[Emily Fortuna, 2012/07/31 05:52:53]

why make pattern optional?

[Alan Knight, 2012/08/03 23:02:15]

OK, made it required.

+   * If [locale] is not specified, then we default to the locale specified

[Emily Fortuna, 2012/07/31 05:52:53]

desiredLocale

[Alan Knight, 2012/08/03 23:02:15]

Done.

+   * in this instance. Note that this is different from using the static

[Emily Fortuna, 2012/07/31 05:52:53]

"locale specified in this instance" please clarify.

[Alan Knight, 2012/08/03 23:02:15]

Done.

+   * version of this, in which case we will default to the overall default

[Emily Fortuna, 2012/07/31 05:52:53]

please rephrase this last sentence. "this" is a bit unclear unless you re-read
the sentence carefully.

[Alan Knight, 2012/08/03 23:02:15]

Moot, since I removed the static version as per a later comment.

+   * locale.
+   */
+  DateFormat date([String pattern, String desiredLocale]) {
+    var actualLocale = (desiredLocale == null) ? _locale : desiredLocale;
+    return new DateFormat(pattern,actualLocale);
+  }
+
+  /**
+   * Return a new date format using the specified [pattern] or with no
+   * pattern if it was omitted. In the second case we assume that pattern
+   * will be set later, otherwise the format is not useful.
+   * If [locale] is not specified, then we use the global default locale.
+   * Note that this is different from using the instance method
+   * version of this, in which case we will default to the locale of that
+   * instance.
+   */
+  static DateFormat Date([pattern, desiredLocale]) {

[Emily Fortuna, 2012/07/31 05:52:53]

types for parameters

[Alan Knight, 2012/08/03 23:02:15]

Method removed.

+    //TODO(alanknight): I don't love the uppercase for static convention here
+    // but couldn't come up with better names, and it seems useful to be able
+    // to do this both statically and on an instance.

[Emily Fortuna, 2012/07/31 05:52:53]

if you're going to do this statically the user might as well just create a Date
object explicitly. Let's provide one way to use the Intl object, and you have to
construct the DateFormatting objects explicitly if you want to do "on the fly"
locale detection versus a specific locale.

[Alan Knight, 2012/08/03 23:02:15]

Done.

+    var actualLocale = (desiredLocale == null) ? defaultLocale: desiredLocale;
+    return new DateFormat(pattern,actualLocale);
+  }
 
   /**
    * Constructor optionally [_locale] for specifics of the language
    * locale to be used, otherwise, we will attempt to infer it (acceptable if
    * Dart is running on the client, we can infer from the browser/client
    * preferences).
    */
-  Intl([this._locale]) {
+  Intl([locale]) {
+    _locale = locale;
     intlMsg = new IntlMessage(_locale);
-    date = new DateFormat(_locale);
   }
 
   /**
    * Create a message that can be internationalized. It takes a
    * [message_str] that will be translated, which may be interpolated
    * based on one or more variables, a [desc] providing a description of usage
    * for the [message_str], and a map of [examples] for each data element to be
    * substituted into the message. For example, if message="Hello, $name", then
    * examples = {'name': 'Sparky'}. The values of [desc] and [examples] are
    * not used at run-time but are only made available to the translators, so
    * they MUST be simple Strings available at compile time: no String
    * interpolation or concatenation.
    * The expected usage of this is inside a function that takes as parameters
    * the variables used in the interpolated string.
    */
   String message(String message_str, [final String desc='',
                  final Map examples=const {}]) {
     return message_str;
   }
 
+  /** The default locale for this environment. */
+  //TODO(alanknight): Return the correct locale using either
+  // window.navigator.language or appropriate environment variable or other
+  // mechanism for command-line apps.
+  static String defaultLocale = 'en_US';
+
+  /**
+   * Return the locale for this instance. If none was set, returns the
+   * default.
+   */
+  String get locale() {
+    if (_locale == null) {

[Emily Fortuna, 2012/07/31 05:52:53]

please sync your files before submitting for review. This mechanism is built
into the constructor in the current version in the repo.

+      return defaultLocale;
+    } else {
+      return _locale;}
+  }
+
   /**
    * Support method for message formatting. Select the correct plural form from
    * [cases] given [howMany].
    */
   static String plural(var howMany, Map cases, [num offset=0]) {
     // TODO(efortuna): Deal with "few" and "many" cases, offset, and others!
     // TODO(alanknight): Should we have instance methods instead/as well?
     // Or have the others as statics?
     return select(howMany.toString(), cases);
   }
 
   /**
    * Support method for message formatting. Select the correct exact (gender,
    * usually) form from [cases] given the user [choice].
    */
   static String select(String choice, Map cases) {
     if (cases.containsKey(choice)) {
       return cases[choice];
     } else if (cases.containsKey('other')){
       return cases['other'];
     } else {
       return '';
     }
   }
 }