Refactor Date.

corelib/src/date.dart

 // Copyright (c) 2011, 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.
 
 // Dart core library.
 
 /**
+ * Returns the local time-zone as defined in the official zone.tab file.
+ *
+ * Examples: [:"Europe/Andorra":], [:"America/Los_Angeles":] or
+ * [:"Europe/Paris":].
+ *
+ * If the underlying implementation is unable to get the timezone string
+ * returns the offset to UTC prefixed with "GMT". Examples: [:"GMT+03":],
+ * [:"GMT-02":], or [:"GTM+04:30":].
+ */
+String get timeZoneName() => DateImplementation.timeZoneName();
+
+/** Returns the current local time-zone's offset to UTC. */
+Duration get timeZoneOffset() => DateImplementation.timeZoneOffset();
+
+/**
  * Date is the public interface to a point in time.
  */
 interface Date extends Comparable, Hashable default DateImplementation {
   // Weekday constants that are returned by [weekday] method:
   static final int MON = 0;
   static final int TUE = 1;
   static final int WED = 2;
   static final int THU = 3;
   static final int FRI = 4;
   static final int SAT = 5;
@@ skipping 22 matching lines @@
   // tools don't yet. Eventually we want to have default values here.
   Date(int year,
        [int month,
         int day,
         int hours,
         int minutes,
         int seconds,
         int milliseconds]);
 
   /**
-   * Constructs a [Date] instance based on the individual parts.
-   * [timeZone] may not be [:null:].
-   */
-  Date.withTimeZone(int year,
-                    int month,
-                    int day,
-                    int hours,
-                    int minutes,
-                    int seconds,
-                    int milliseconds,
-                    TimeZone timeZone);
-
-  /**
-   * Constructs a new [Date] instance with current date time value.
-   * The [timeZone] of this instance is set to the local time-zone.
+   * Constructs a new [Date] instance with current date time value in the
+   * local time-zone.
    */
   Date.now();
 
   /**
    * Constructs a new [Date] instance based on [formattedString].
    */
   Date.fromString(String formattedString);
 
   /**
-   * Constructs a new [Date] instance with the given time zone. The given
-   * [timeZone] must not be [:null:].
+   * Constructs a new [Date] instance in the local time-zone.
    *
    * This constructor is the only one that doesn't need to be computations and
    * which can therefore be [:const:].
    *
    * The constructed [Date] represents 1970-01-01T00:00:00Z + [value]ms in
-   * the given [timeZone].
+   * the local time-zone.
    */
-  const Date.fromEpoch(int value, TimeZone timeZone);
+  const Date.fromEpoch(int value);
 
   /**
    * Returns true if [this] occurs before [other]. The comparison is independent
    * of the timezone the [Date] is in.
    */
   bool operator <(Date other);
   /**
    * Returns true if [this] occurs at the same time or before [other]. The
    * comparison is independent of the timezone the [Date] is in.
    */
   bool operator <=(Date other);
   /**
    * Returns true if [this] occurs after [other]. The comparison is independent
    * of the timezone the [Date] is in.
    */
   bool operator >(Date other);
   /**
    * Returns true if [this] occurs at the same time or after [other]. The
    * comparison is independent of the timezone the [Date] is in.
    */
   bool operator >=(Date other);
 
   /**
-   * Returns a new [Date] in the given [targetTimeZone] time zone. The
-   * [value] of the new instance is equal to [:this.value:].
-   *
-   * This call is equivalent to
-   *  [:new Date.fromEpoch(this.value, targetTimeZone):].
-   */
-  Date changeTimeZone(TimeZone targetTimeZone);
-
-  /**
    * Returns the year.
    */
   int get year();
 
   /**
    * Returns the month in the year [1..12].
    */
   int get month();
 
   /**
@@ skipping 22 matching lines @@
   int get milliseconds();
 
   /**
    * Returns the week day [MON..SUN]
    */
   int get weekday();
 
   /**
    * Returns milliseconds from 1970-01-01T00:00:00Z (UTC).
    *
-   * Note that this value is independent of [timeZone].
+   * Note that this value is independent of any time-zone.
    */
   final int value;
 
   /**
-   * Returns the timeZone of this instance.
-   */
-  final TimeZone timeZone;
-
-  /**
-   * Returns true if this [Date] is set to local time.
-   */
-  bool isLocalTime();
-
-  /**
-   * Returns true if this [Date] is set to UTC time.
-   * This is equivalent to [:this.timeZone.isUtc():].
-   */
-  bool isUtc();
-
-  /**
-   * Returns a human readable string for this instance.
-   * The returned string is constructed for the [timeZone] of this instance.
+   * Returns a human readable string for this instance. The returned string
+   * is constructed in the local time-zone and does not have any time-zone
+   * indication. Example: [:2012-05-14 14:20:25.442:]
    */
   String toString();
 
   /**
+  * Returns a human readable string for this instance in UTC time-zone.
+  * Example: [:2012-05-14 12:21:04.989Z:]
+  */
+  String toUtcString();
+
+  /**
    * Returns a new [Date] with the [duration] added to this instance.
    */
   Date add(Duration duration);
 
   /**
    * Returns a new [Date] with the [duration] subtracted from this instance.
    */
   Date subtract(Duration duration);
 
   /**
    * Returns a [Duration] with the difference of [:this:] and [other].
    */
   Duration difference(Date other);
 }