Struct Instant

Represents an instant on the global timeline.
Since 1.0.x
Availability net35-Client, PCL
Inherited Members
System.Object.Equals(System.Object, System.Object)
Namespace: NodaTime
Assembly: NodaTime.dll
Syntax
public struct Instant : IEquatable<Instant>, IComparable<Instant>, IFormattable, IComparable
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Constructors

Instant(Int64)

Initializes a new instance of the Instant struct.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public Instant(long ticks)
Parameters
Type Name Description
Int64 ticks The number of ticks since the Unix epoch. Negative values represent instants before the Unix epoch.
Remarks
Note that while the Noda Time Instant type and BCL DateTime and System.DateTimeOffset types are all defined in terms of a number of ticks, they use different origins: the Noda Time types count ticks from the Unix epoch (the start of 1970 AD), while the BCL types count from the start of 1 AD. This constructor requires the former; to convert from a number-of-ticks since the BCL epoch, construct a DateTime first, then use FromDateTimeUtc(DateTime).

Fields

MaxValue

Represents the largest possible Instant.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static readonly Instant MaxValue
Field Value
Type Description
Instant
Remarks
Within Noda Time, this is also used to represent 'the end of time'.

MinValue

Represents the smallest possible Instant.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static readonly Instant MinValue
Field Value
Type Description
Instant
Remarks
Within Noda Time, this is also used to represent 'the beginning of time'.

Properties

Ticks

The number of ticks since the Unix epoch. Negative values represent instants before the Unix epoch.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public long Ticks { get; }
Property Value
Type Description
Int64
Remarks
A tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

Methods

Add(Instant, Duration)

Adds a duration to an instant. Friendly alternative to operator+().
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant Add(Instant left, Duration right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Duration right The right hand side of the operator.
Returns
Type Description
Instant A new Instant representing the sum of the given values.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

CompareTo(Instant)

Compares the current object with another object of the same type.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public int CompareTo(Instant other)
Parameters
Type Name Description
Instant other An object to compare with this object.
Returns
Type Description
Int32 A 32-bit signed integer that indicates the relative order of the objects being compared. The return value has the following meanings:
ValueMeaning
< 0This object is less than the other parameter.
0This object is equal to other.
> 0This object is greater than other.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Equals(Instant)

Indicates whether the value of this instant is equal to the value of the specified instant.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public bool Equals(Instant other)
Parameters
Type Name Description
Instant other The value to compare with this instance.
Returns
Type Description
System.Boolean true if the value of this instant is equal to the value of the other parameter; otherwise, false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Equals(Object)

Determines whether the specified System.Object is equal to this instance.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public override bool Equals(object obj)
Parameters
Type Name Description
System.Object obj The System.Object to compare with this instance.
Returns
Type Description
System.Boolean true if the specified System.Object is equal to this instance; otherwise, false.
Overrides
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

FromDateTimeOffset(DateTimeOffset)

Converts a System.DateTimeOffset into a new Instant representing the same instant in time. Note that the offset information is not preserved in the returned Instant.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant FromDateTimeOffset(DateTimeOffset dateTimeOffset)
Parameters
Type Name Description
System.DateTimeOffset dateTimeOffset Date and time value with an offset.
Returns
Type Description
Instant An Instant value representing the same instant in time as the given System.DateTimeOffset.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

FromDateTimeUtc(DateTime)

Converts a DateTime into a new Instant representing the same instant in time.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant FromDateTimeUtc(DateTime dateTime)
Parameters
Type Name Description
DateTime dateTime Date and time value which must have a Kind of System.DateTimeKind.Utc
Returns
Type Description
Instant An Instant value representing the same instant in time as the given universal DateTime.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Exceptions
Type Condition
ArgumentException dateTime is not of Kind System.DateTimeKind.Utc.

FromMillisecondsSinceUnixEpoch(Int64)

Initializes a new instance of the Instant struct based on a number of milliseconds since the Unix epoch of (ISO) January 1st 1970, midnight, UTC.
Since 1.1.x
Availability net35-Client, PCL
Declaration
public static Instant FromMillisecondsSinceUnixEpoch(long milliseconds)
Parameters
Type Name Description
Int64 milliseconds Number of milliseconds since the Unix epoch. May be negative (for instants before the epoch).
Returns
Type Description
Instant An Instant at exactly the given number of milliseconds since the Unix epoch.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Exceptions
Type Condition
System.ArgumentOutOfRangeException The constructed instant would be out of the range representable in Noda Time.

FromSecondsSinceUnixEpoch(Int64)

Initializes a new instance of the Instant struct based on a number of seconds since the Unix epoch of (ISO) January 1st 1970, midnight, UTC.
Since 1.1.x
Availability net35-Client, PCL
Declaration
public static Instant FromSecondsSinceUnixEpoch(long seconds)
Parameters
Type Name Description
Int64 seconds Number of seconds since the Unix epoch. May be negative (for instants before the epoch).
Returns
Type Description
Instant An Instant at exactly the given number of seconds since the Unix epoch.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Exceptions
Type Condition
System.ArgumentOutOfRangeException The constructed instant would be out of the range representable in Noda Time.

FromTicksSinceUnixEpoch(Int64)

Initializes a new instance of the Instant struct based on a number of ticks since the Unix epoch of (ISO) January 1st 1970, midnight, UTC.
Since 1.1.x
Availability net35-Client, PCL
Declaration
public static Instant FromTicksSinceUnixEpoch(long ticks)
Parameters
Type Name Description
Int64 ticks Number of ticks since the Unix epoch. May be negative (for instants before the epoch).
Returns
Type Description
Instant An Instant at exactly the given number of ticks since the Unix epoch.
Remarks
This is equivalent to calling the constructor directly, but indicates intent more explicitly.

FromUtc(Int32, Int32, Int32, Int32, Int32)

Returns a new instant corresponding to the given UTC date and time in the ISO calendar. In most cases applications should use ZonedDateTime to represent a date and time, but this method is useful in some situations where an Instant is required, such as time zone testing.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant FromUtc(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour)
Parameters
Type Name Description
Int32 year The year. This is the "absolute year", so a value of 0 means 1 BC, for example.
Int32 monthOfYear The month of year.
Int32 dayOfMonth The day of month.
Int32 hourOfDay The hour.
Int32 minuteOfHour The minute.
Returns
Type Description
Instant An Instant value representing the given date and time in UTC and the ISO calendar.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

FromUtc(Int32, Int32, Int32, Int32, Int32, Int32)

Returns a new instant corresponding to the given UTC date and time in the ISO calendar. In most cases applications should use ZonedDateTime to represent a date and time, but this method is useful in some situations where an Instant is required, such as time zone testing.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant FromUtc(int year, int monthOfYear, int dayOfMonth, int hourOfDay, int minuteOfHour, int secondOfMinute)
Parameters
Type Name Description
Int32 year The year. This is the "absolute year", so a value of 0 means 1 BC, for example.
Int32 monthOfYear The month of year.
Int32 dayOfMonth The day of month.
Int32 hourOfDay The hour.
Int32 minuteOfHour The minute.
Int32 secondOfMinute The second.
Returns
Type Description
Instant An Instant value representing the given date and time in UTC and the ISO calendar.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

GetHashCode()

Returns a hash code for this instance.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public override int GetHashCode()
Returns
Type Description
Int32 A hash code for this instance, suitable for use in hashing algorithms and data structures like a hash table.
Overrides
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

InUtc()

Returns the ZonedDateTime representing the same point in time as this instant, in the UTC time zone and ISO-8601 calendar. This is a shortcut for calling InZone(DateTimeZone) with an argument of Utc.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public ZonedDateTime InUtc()
Returns
Type Description
ZonedDateTime A ZonedDateTime for the same instant, in the UTC time zone and the ISO-8601 calendar
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

InZone(DateTimeZone)

Returns the ZonedDateTime representing the same point in time as this instant, in the specified time zone and ISO-8601 calendar.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public ZonedDateTime InZone(DateTimeZone zone)
Parameters
Type Name Description
DateTimeZone zone The time zone in which to represent this instant.
Returns
Type Description
ZonedDateTime A ZonedDateTime for the same instant, in the given time zone and the ISO-8601 calendar
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Exceptions
Type Condition
ArgumentNullException zone is null.

InZone(DateTimeZone, CalendarSystem)

Returns the ZonedDateTime representing the same point in time as this instant, in the specified time zone and calendar system.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public ZonedDateTime InZone(DateTimeZone zone, CalendarSystem calendar)
Parameters
Type Name Description
DateTimeZone zone The time zone in which to represent this instant.
CalendarSystem calendar The calendar system in which to represent this instant.
Returns
Type Description
ZonedDateTime A ZonedDateTime for the same instant, in the given time zone and calendar
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Exceptions
Type Condition
ArgumentNullException zone or calendar is null.

Max(Instant, Instant)

Returns the later instant of the given two.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant Max(Instant x, Instant y)
Parameters
Type Name Description
Instant x The first instant to compare.
Instant y The second instant to compare.
Returns
Type Description
Instant The later instant of x or y.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Min(Instant, Instant)

Returns the earlier instant of the given two.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant Min(Instant x, Instant y)
Parameters
Type Name Description
Instant x The first instant to compare.
Instant y The second instant to compare.
Returns
Type Description
Instant The earlier instant of x or y.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Minus(Duration)

Returns the result of subtracting a duration from this instant, for a fluent alternative to operator-().
Since 1.0.x
Availability net35-Client, PCL
Declaration
public Instant Minus(Duration duration)
Parameters
Type Name Description
Duration duration The duration to subtract
Returns
Type Description
Instant A new Instant representing the result of the subtraction.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Minus(Instant)

Returns the result of subtracting another instant from this one, for a fluent alternative to operator-().
Since 1.0.x
Availability net35-Client, PCL
Declaration
public Duration Minus(Instant other)
Parameters
Type Name Description
Instant other The other instant to subtract
Returns
Type Description
Duration A new Instant representing the result of the subtraction.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Plus(Duration)

Returns the result of adding a duration to this instant, for a fluent alternative to operator+().
Since 1.0.x
Availability net35-Client, PCL
Declaration
public Instant Plus(Duration duration)
Parameters
Type Name Description
Duration duration The duration to add
Returns
Type Description
Instant A new Instant representing the result of the addition.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

PlusTicks(Int64)

Returns a new value of this instant with the given number of ticks added to it.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public Instant PlusTicks(long ticksToAdd)
Parameters
Type Name Description
Int64 ticksToAdd The ticks to add to this instant to create the return value.
Returns
Type Description
Instant The result of adding the given number of ticks to this instant.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Subtract(Instant, Duration)

Subtracts a duration from an instant. Friendly alternative to operator-().
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant Subtract(Instant left, Duration right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Duration right The right hand side of the operator.
Returns
Type Description
Instant A new Instant representing the difference of the given values.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Subtract(Instant, Instant)

Subtracts one instant from another. Friendly alternative to operator-().
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Duration Subtract(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
Duration A new Duration representing the difference of the given values.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

ToDateTimeOffset()

Constructs a System.DateTimeOffset from this Instant which has an offset of zero.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public DateTimeOffset ToDateTimeOffset()
Returns
Type Description
System.DateTimeOffset A System.DateTimeOffset representing the same instant in time as this value.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

ToDateTimeUtc()

Constructs a DateTime from this Instant which has a Kind of System.DateTimeKind.Utc and represents the same instant of time as this value.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public DateTime ToDateTimeUtc()
Returns
Type Description
DateTime A DateTime representing the same instant in time as this value, with a kind of "universal".
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

ToString()

Returns a String that represents this instance.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public override string ToString()
Returns
Type Description
String The value of the current instance in the standard format pattern, using the current thread's culture to obtain a format provider.
Overrides
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

ToString(String, IFormatProvider)

Formats the value of the current instance using the specified pattern.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public string ToString(string patternText, IFormatProvider formatProvider)
Parameters
Type Name Description
String patternText The String specifying the pattern to use, or null to use the default format pattern.
IFormatProvider formatProvider The IFormatProvider to use when formatting the value, or null to use the current thread's culture to obtain a format provider.
Returns
Type Description
String A String containing the value of the current instance in the specified format.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Operators

Addition(Instant, Duration)

Implements the operator + (addition) for Instant + Duration.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant operator +(Instant left, Duration right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Duration right The right hand side of the operator.
Returns
Type Description
Instant A new Instant representing the sum of the given values.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Equality(Instant, Instant)

Implements the operator == (equality).
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static bool operator ==(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
System.Boolean true if values are equal to each other, otherwise false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

GreaterThan(Instant, Instant)

Implements the operator > (greater than).
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static bool operator>(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
System.Boolean true if the left value is greater than the right value, otherwise false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

GreaterThanOrEqual(Instant, Instant)

Implements the operator >= (greater than or equal).
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static bool operator >=(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
System.Boolean true if the left value is greater than or equal to the right value, otherwise false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Inequality(Instant, Instant)

Implements the operator != (inequality).
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static bool operator !=(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
System.Boolean true if values are not equal to each other, otherwise false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

LessThan(Instant, Instant)

Implements the operator < (less than).
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static bool operator <(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
System.Boolean true if the left value is less than the right value, otherwise false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

LessThanOrEqual(Instant, Instant)

Implements the operator <= (less than or equal).
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static bool operator <=(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
System.Boolean true if the left value is less than or equal to the right value, otherwise false.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Subtraction(Instant, Duration)

Implements the operator - (subtraction) for Instant - Duration.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Instant operator -(Instant left, Duration right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Duration right The right hand side of the operator.
Returns
Type Description
Instant A new Instant representing the difference of the given values.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Subtraction(Instant, Instant)

Implements the operator - (subtraction) for Instant - Instant.
Since 1.0.x
Availability net35-Client, PCL
Declaration
public static Duration operator -(Instant left, Instant right)
Parameters
Type Name Description
Instant left The left hand side of the operator.
Instant right The right hand side of the operator.
Returns
Type Description
Duration A new Instant representing the difference of the given values.
Remarks

An instant is defined by an integral number of 'ticks' since the Unix epoch (typically described as January 1st 1970, midnight, UTC, ISO calendar), where a tick is equal to 100 nanoseconds. There are 10,000 ticks in a millisecond.

An Instant has no concept of a particular time zone or calendar: it simply represents a point in time that can be globally agreed-upon.

Explicit Interface Implementations

IComparable.CompareTo(Object)

Implementation of CompareTo(Object) to compare two instants.
Since 1.0.x
Availability net35-Client, PCL
Declaration
int IComparable.CompareTo(object obj)
Parameters
Type Name Description
System.Object obj The object to compare this value with.
Returns
Type Description
Int32 The result of comparing this instant with another one; see CompareTo(Instant) for general details. If obj is null, this method returns a value greater than 0.
Remarks
This uses explicit interface implementation to avoid it being called accidentally. The generic implementation should usually be preferred.
Exceptions
Type Condition
ArgumentException obj is non-null but does not refer to an instance of Instant.

Implements