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.
Default class
Extends
Implemented by
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
Methods
Code Date add(Duration duration) #
Returns a new Date with the duration added to this instance.
Date add(Duration duration);
Code Duration difference(Date other) #
Returns a Duration with the difference of this
and
other.
Duration difference(Date other);
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 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 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();