Make most arguments to Date constructor optional.

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.
 
 /**
  * Date is the public interface to a point in time.
  */
 interface Date extends Comparable, Hashable default DateImplementation {
@@ skipping 18 matching lines @@
   static final int AUG = 8;
   static final int SEP = 9;
   static final int OCT = 10;
   static final int NOV = 11;
   static final int DEC = 12;
 
   /**
    * Constructs a [Date] instance based on the individual parts, in the
    * local time-zone.
    */
+  // TODO(floitsch): the spec allows default values in interfaces, but our
+  // our tools don't yet. Eventually we want to have default values here.

[ngeoffray, 2012/05/15 12:17:35]

our our -> our

[floitsch, 2012/05/15 12:34:22]

Done.

   Date(int year,
-       int month,

[sorinmocanu, 2012/05/15 12:21:59]

Where will you document the possible combinations of arguments which are
possible?
Crazy example, should a date implementation support year + hours?

[floitsch, 2012/05/15 12:34:22]

Each argument has a default value. 1 for month and day, and 0 for the others.
Each can be passed as named argument without affecting the others.
So yes: new Date(2012, milliseconds: 499) is legal (although probably not very
common).

-       int day,
-       int hours,
-       int minutes,
-       int seconds,
-       int milliseconds);
+       [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,
@@ skipping 110 matching lines @@
   /**
    * 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);
 }