Date Interface / dart:core Library / Dart API Reference

Date Interface

Date is the public interface to a point in time.

It can represent time values that are at a distance of at most 8,640,000,000,000,000ms (100,000,000 days) from epoch (1970-01-01 UTC). In other words: millisecondsSinceEpoch.abs() <= 8640000000000000.

Also see Stopwatch for means to measure time-spans.

Constructors

Code new Date.fromString(String formattedString) #

Constructs a new Date instance based on formattedString.

Date.fromString(String formattedString);

Code new Date.now() #

Constructs a new Date instance with current date time value in the local time zone.

Date.now();

Code new Date(int year, [int month, int day, int hour, int minute, int second, int millisecond, bool isUtc]) #

Constructs a Date instance based on the individual parts. The date is in the local time zone if isUtc is false.

month and day are one-based. For example :new Date(1938, 1, 10) represents the 10th of January 1938.

Date(int year,
     [int month,
      int day,
      int hour,
      int minute,
      int second,
      int millisecond,
      bool isUtc]);

Code new Date.fromMillisecondsSinceEpoch(int millisecondsSinceEpoch, [bool isUtc]) #

Constructs a new Date instance with the given millisecondsSinceEpoch. If isUtc is false then the date is in the local time zone.

The constructed Date represents 1970-01-01T00:00:00Z + millisecondsSinceEpochms in the given time zone (local or UTC).

Date.fromMillisecondsSinceEpoch(int millisecondsSinceEpoch, [bool isUtc]);

Static Fields

Code final int APR #

static final int APR = 4;

Code final int AUG #

static final int AUG = 8;

Code final int DAYS_IN_WEEK #

static final int DAYS_IN_WEEK = 7;

Code final int DEC #

static final int DEC = 12;

Code final int FEB #

static final int FEB = 2;

Code final int FRI #

static final int FRI = 5;

Code final int JAN #

static final int JAN = 1;

Code final int JUL #

static final int JUL = 7;

Code final int JUN #

static final int JUN = 6;

Code final int MAR #

static final int MAR = 3;

Code final int MAY #

static final int MAY = 5;

Code final int MON #

static final int MON = 1;

Code final int NOV #

static final int NOV = 11;

Code final int OCT #

static final int OCT = 10;

Code final int SAT #

static final int SAT = 6;

Code final int SEP #

static final int SEP = 9;

Code final int SUN #

static final int SUN = 7;

Code final int THU #

static final int THU = 4;

Code final int TUE #

static final int TUE = 2;

Code final int WED #

static final int WED = 3;

Methods

Code Date add(Duration duration) #

Returns a new Date with the duration added to this instance.

Date add(Duration duration);

Code int get day() #

Returns the day into the month 1..31.

int get day();

Code Duration difference(Date other) #

Returns a Duration with the difference of this and other.

Duration difference(Date other);

Code int get hour() #

Returns the hour into the day 0..23.

int get hour();

Code bool get isUtc() #

True if this Date is set to UTC time.

bool get isUtc();

Code int get millisecond() #

Returns the millisecond into the second 0...999.

int get millisecond();

Code int get millisecondsSinceEpoch() #

The milliseconds since 1970-01-01T00:00:00Z (UTC). This value is independent of the time zone.

See Stopwatch for means to measure time-spans.

int get millisecondsSinceEpoch();

Code int get minute() #

Returns the minute into the hour 0...59.

int get minute();

Code int get month() #

Returns the month into the year 1..12.

int get month();

Code bool operator >(Date other) #

Returns true if this occurs after other. The comparison is independent of whether the time is utc or in the local time zone.

bool operator >(Date other);

Code bool operator <(Date other) #

Returns true if this occurs before other. The comparison is independent of whether the time is utc or in the local time zone.

bool operator <(Date other);

Code bool operator ==(Date other) #

Returns true if this occurs at the same time as other. The comparison is independent of whether the time is utc or in the local time zone.

bool operator ==(Date other);

Code bool operator >=(Date other) #

Returns true if this occurs at the same time or after other. The comparison is independent of whether the time is utc or in the local time zone.

bool operator >=(Date other);

Code bool operator <=(Date other) #

Returns true if this occurs at the same time or before other. The comparison is independent of whether the time is utc or in the local time zone.

bool operator <=(Date other);

Code int get second() #

Returns the second into the minute 0...59.

int get second();

Code Date subtract(Duration duration) #

Returns a new Date with the duration subtracted from this instance.

Date subtract(Duration duration);

Code String get timeZoneName() #

Returns the abbreviated time-zone name.

Examples: "CET" or "CEST".

String get timeZoneName();

Code Duration get timeZoneOffset() #

The time-zone offset is the difference between local time and UTC. That is, the offset is positive for time zones west of UTC.

Note, that JavaScript, Python and C return the difference between UTC and local time. Java, C# and Ruby return the difference between local time and UTC.

Duration get timeZoneOffset();

Code Date toLocal() #

Returns this in the local time zone. Returns itself if it is already in the local time zone. Otherwise, this method is equivalent to new Date.fromMillisecondsSinceEpoch(millisecondsSinceEpoch, false).

Date toLocal();

Code String toString() #

Returns a human readable string for this instance. The returned string is constructed for the time zone of this instance.

String toString();

Code Date toUtc() #

Returns this in UTC. Returns itself if it is already in UTC. Otherwise, this method is equivalent to new Date.fromMillisecondsSinceEpoch(millisecondsSinceEpoch, true).

Date toUtc();

Code int get weekday() #

Returns the week day MON..SUN. In accordance with ISO 8601 a week starts with Monday which has the value 1.

int get weekday();

Code int get year() #

Returns the year.

int get year();