ThreeTen-Extra 1.8.0 · org.threeten.extra.scale.UtcInstant

An instantaneous point on the time-line measured in the UTC time-scale with leap seconds.

The java.time classes use the Java time-scale for simplicity. That scale works on the assumption that the time-line is simple, there are no leap-seconds and there are always 24 * 60 * 60 seconds in a day. Unfortunately, the Earth's rotation is not straightforward, and a solar day does not match this definition.

This class is an alternative representation based on the UTC time-scale which includes leap-seconds. Leap-seconds are additional seconds that are inserted into the year-month-day-hour-minute-second time-line in order to keep UTC in line with the solar day. When a leap second occurs, an accurate clock will show the time 23:59:60 just before midnight.

Leap-seconds are announced in advance, typically at least six months. The UtcRules class models which dates have leap-seconds. All the methods on this class use the latest available system rules.

The system leap-second rules fix the start point of UTC as 1972. This date was chosen as UTC was more complex before 1972.

The duration between two points on the UTC time-scale is calculated solely using this class. Do not use the between method on Duration as that will lose information. Instead use durationUntil(UtcInstant) on this class.

It is intended that most applications will use the Instant class which uses the UTC-SLS mapping from UTC to guarantee 86400 seconds per day. Specialist applications with access to an accurate time-source may find this class useful.

Time-scale

The length of the solar day is the standard way that humans measure time. As the Earth's rotation changes, the length of the day varies. In general, a solar day is slightly longer than 86400 SI seconds. The actual length is not predictable and can only be determined by measurement. The UT1 time-scale captures these measurements.

The UTC time-scale is a standard approach to bundle up all the additional fractions of a second from UT1 into whole seconds, known as leap-seconds. A leap-second may be added or removed depending on the Earth's rotational changes. If it is removed, then the relevant date will have no time of 23:59:59. If it is added, then the relevant date will have an extra second of 23:59:60.

The modern UTC time-scale was introduced in 1972, introducing the concept of whole leap-seconds. Between 1958 and 1972, the definition of UTC was complex, with minor sub-second leaps and alterations to the length of the notional second.

This class may be used for instants in the far past and far future. Since some instants will be prior to 1972, it is not strictly an implementation of UTC. Instead, it is a proleptic time-scale based on TAI and equivalent to it since 1972.

Implementation Requirements:

This class is immutable and thread-safe.

This class must be treated as a value type. Do not synchronize, rely on the identity hash code or use the distinction between equals() and ==.

Field Summary

Modifier and Type	Field and Description
private final long	mjDay The Modified Julian Day, from the epoch of 1858-11-17.
private final long	nanoOfDay The number of nanoseconds, later along the time-line, from the MJD field.
private static final long	serialVersionUID Serialization version.
private transient String	toString A cache of the result from `toString()`

Constructor Summary

Access	Constructor and Description
private	UtcInstant(long the date as a Modified Julian Day (number of days from the epoch of 1858-11-17) mjDay, long the nanoseconds within the day, including leap seconds nanoOfDay) Constructs an instance.

Method Summary

Modifier and Type	Method and Description
private String	buildToString()
public int	Returns: the comparator value, negative if less, positive if greater compareTo(UtcInstant the other instant to compare to, not null otherInstant) Implements java.lang.Comparable.compareTo. Compares this instant to another based on the time-line.
public Duration	Returns: the duration until the specified instant, may be negative, not null durationUntil(UtcInstant the instant to calculate the duration until, not null utcInstant) Returns the duration between this instant and the specified instant.
public boolean	Returns: true if the other instant is equal to this one equals(Object the other instant, null returns false otherInstant) Overrides java.lang.Object.equals. Checks if this instant is equal to the specified `UtcInstant`.
public long	Returns: the Modified Julian Day based on the epoch 1858-11-17 getModifiedJulianDay() Gets the Modified Julian Day (MJD).
public long	Returns: the nanoseconds within the day, including leap seconds getNanoOfDay() Gets the number of nanoseconds, later along the time-line, from the start of the Modified Julian Day.
public int	Returns: a suitable hash code hashCode() Overrides java.lang.Object.hashCode. Returns a hash code for this instant.
public boolean	Returns: true if this instant is after the specified instant isAfter(UtcInstant the other instant to compare to, not null otherInstant) Checks if this instant is after the specified instant.
public boolean	Returns: true if this instant is before the specified instant isBefore(UtcInstant the other instant to compare to, not null otherInstant) Checks if this instant is before the specified instant.
public boolean	Returns: true if this instant is within a leap second isLeapSecond() Checks if the instant is within a leap second.
public UtcInstant	Returns: a `UtcInstant` with the duration subtracted, not null minus(Duration the duration to subtract, not null duration) Returns a copy of this instant with the specified duration subtracted.
public static UtcInstant	Returns: the UTC instant, not null of(Instant the instant to convert, not null instant) Obtains an instance of `UtcInstant` from an `Instant`.
public static UtcInstant	Returns: the UTC instant, not null of(TaiInstant the instant to convert, not null instant) Obtains an instance of `UtcInstant` from a `TaiInstant`.
public static UtcInstant	Returns: the UTC instant, not null ofModifiedJulianDay(long the date as a Modified Julian Day (number of days from the epoch of 1858-11-17) mjDay, long the nanoseconds within the day, including leap seconds nanoOfDay) Obtains an instance of `UtcInstant` from a Modified Julian Day with a nanosecond fraction of day.
public static UtcInstant	Returns: the parsed instant, not null parse(CharSequence the text to parse such as "2007-12-03T10:15:30.00Z", not null text) Obtains an instance of `UtcInstant` from a text string, such as `2007-12-03T10:15:30.00Z`.
public UtcInstant	Returns: a `UtcInstant` with the duration added, not null plus(Duration the duration to add, not null duration) Returns a copy of this instant with the specified duration added.
public Instant	Returns: an `Instant` representing the best approximation of this instant, not null toInstant() Converts this instant to an `Instant`.
public String	Returns: a representation of this instant, not null toString() Overrides java.lang.Object.toString. A string representation of this instant.
public TaiInstant	Returns: a `TaiInstant` representing the same instant, not null toTaiInstant() Converts this instant to a `TaiInstant`.
public UtcInstant	Returns: a `UtcInstant` based on this instant with the requested day, not null withModifiedJulianDay(long the date as a Modified Julian Day (number of days from the epoch of 1858-11-17) mjDay) Returns a copy of this `UtcInstant` with the Modified Julian Day (MJD) altered.
public UtcInstant	Returns: a `UtcInstant` based on this instant with the requested nano-of-day, not null withNanoOfDay(long the nanoseconds within the day, including leap seconds nanoOfDay) Returns a copy of this `UtcInstant` with the nano-of-day altered.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

mjDay	back to summary
private final long mjDay The Modified Julian Day, from the epoch of 1858-11-17.

nanoOfDay	back to summary
private final long nanoOfDay The number of nanoseconds, later along the time-line, from the MJD field. This is always positive and includes leap seconds.

serialVersionUID	back to summary
private static final long serialVersionUID Serialization version.

toString	back to summary
private transient String toString A cache of the result from `toString()`

Constructor Detail

UtcInstant	back to summary
private UtcInstant(long mjDay, long nanoOfDay) Constructs an instance. Parameters mjDay:long the date as a Modified Julian Day (number of days from the epoch of 1858-11-17) nanoOfDay:long the nanoseconds within the day, including leap seconds

UtcInstant

back to summary

private UtcInstant(long mjDay, long nanoOfDay)

Constructs an instance.

Parameters

mjDay:long: the date as a Modified Julian Day (number of days from the epoch of 1858-11-17)
nanoOfDay:long: the nanoseconds within the day, including leap seconds

Method Detail

buildToString	back to summary
private String buildToString()

compareTo back to summary

compareTo	back to summary
public int compareTo(UtcInstant otherInstant) Implements java.lang.Comparable.compareTo. Compares this instant to another based on the time-line. The comparison is based first on the Modified Julian Day, then on the nano-of-day. It is "consistent with equals", as defined by `Comparable`. Parameters otherInstant:UtcInstant the other instant to compare to, not null Returns:int the comparator value, negative if less, positive if greater Annotations @Override

public int compareTo(UtcInstant otherInstant)

Implements java.lang.Comparable.compareTo.

Compares this instant to another based on the time-line.

The comparison is based first on the Modified Julian Day, then on the nano-of-day. It is "consistent with equals", as defined by Comparable.

Parameters

otherInstant:UtcInstant: the other instant to compare to, not null

Returns:int

the comparator value, negative if less, positive if greater

Annotations

@Override

durationUntil back to summary

durationUntil	back to summary
public Duration durationUntil(UtcInstant utcInstant) Returns the duration between this instant and the specified instant. This calculates the duration between this instant and another based on the UTC time-scale. Any leap seconds that occur will be included in the duration. Adding the duration to this instant using `plus` will always result in an instant equal to the specified instant. Parameters utcInstant:UtcInstant the instant to calculate the duration until, not null Returns:Duration the duration until the specified instant, may be negative, not null Exceptions ArithmeticException: if the calculation exceeds the supported range

public Duration durationUntil(UtcInstant utcInstant)

Returns the duration between this instant and the specified instant.

This calculates the duration between this instant and another based on the UTC time-scale. Any leap seconds that occur will be included in the duration. Adding the duration to this instant using plus will always result in an instant equal to the specified instant.

Parameters

utcInstant:UtcInstant: the instant to calculate the duration until, not null

Returns:Duration

the duration until the specified instant, may be negative, not null

Exceptions

ArithmeticException:: if the calculation exceeds the supported range

equals back to summary

equals	back to summary
public boolean equals(Object otherInstant) Overrides java.lang.Object.equals. Checks if this instant is equal to the specified `UtcInstant`. The comparison is based on the Modified Julian Day, then on the nano-of-day. Parameters otherInstant:Object the other instant, null returns false Returns:boolean true if the other instant is equal to this one Annotations @Override

public boolean equals(Object otherInstant)

Overrides java.lang.Object.equals.

Checks if this instant is equal to the specified UtcInstant.

The comparison is based on the Modified Julian Day, then on the nano-of-day.

Parameters

otherInstant:Object: the other instant, null returns false

Returns:boolean

true if the other instant is equal to this one

Annotations

@Override

getModifiedJulianDay back to summary

getModifiedJulianDay	back to summary
public long getModifiedJulianDay() Gets the Modified Julian Day (MJD). The Modified Julian Day is a simple incrementing count of days where day 0 is 1858-11-17. The nanosecond part of the day is returned by `getNanosOfDay`. The day varies in length, being one second longer on a leap day. Returns:long the Modified Julian Day based on the epoch 1858-11-17

public long getModifiedJulianDay()

Gets the Modified Julian Day (MJD).

The Modified Julian Day is a simple incrementing count of days where day 0 is 1858-11-17. The nanosecond part of the day is returned by getNanosOfDay. The day varies in length, being one second longer on a leap day.

Returns:long: the Modified Julian Day based on the epoch 1858-11-17

getNanoOfDay back to summary

getNanoOfDay	back to summary
public long getNanoOfDay() Gets the number of nanoseconds, later along the time-line, from the start of the Modified Julian Day. The nanosecond-of-day value measures the total number of nanoseconds within the day from the start of the day returned by `getModifiedJulianDay`. This value will include any additional leap seconds. Returns:long the nanoseconds within the day, including leap seconds

public long getNanoOfDay()

Gets the number of nanoseconds, later along the time-line, from the start of the Modified Julian Day.

The nanosecond-of-day value measures the total number of nanoseconds within the day from the start of the day returned by getModifiedJulianDay. This value will include any additional leap seconds.

Returns:long: the nanoseconds within the day, including leap seconds

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Returns a hash code for this instant. Returns:int a suitable hash code Annotations @Override

hashCode

back to summary

public int hashCode()

Overrides java.lang.Object.hashCode.

Returns a hash code for this instant.

Returns:int

a suitable hash code

Annotations

@Override

isAfter	back to summary
public boolean isAfter(UtcInstant otherInstant) Checks if this instant is after the specified instant. The comparison is based on the time-line position of the instants. Parameters otherInstant:UtcInstant the other instant to compare to, not null Returns:boolean true if this instant is after the specified instant Exceptions NullPointerException: if otherInstant is null

isAfter

back to summary

public boolean isAfter(UtcInstant otherInstant)

Checks if this instant is after the specified instant.

The comparison is based on the time-line position of the instants.

Parameters

otherInstant:UtcInstant: the other instant to compare to, not null

Returns:boolean

true if this instant is after the specified instant

Exceptions

NullPointerException:: if otherInstant is null

isBefore	back to summary
public boolean isBefore(UtcInstant otherInstant) Checks if this instant is before the specified instant. The comparison is based on the time-line position of the instants. Parameters otherInstant:UtcInstant the other instant to compare to, not null Returns:boolean true if this instant is before the specified instant Exceptions NullPointerException: if otherInstant is null

isBefore

back to summary

public boolean isBefore(UtcInstant otherInstant)

Checks if this instant is before the specified instant.

The comparison is based on the time-line position of the instants.

Parameters

otherInstant:UtcInstant: the other instant to compare to, not null

Returns:boolean

true if this instant is before the specified instant

Exceptions

NullPointerException:: if otherInstant is null

isLeapSecond	back to summary
public boolean isLeapSecond() Checks if the instant is within a leap second. This method returns true when an accurate clock would return a seconds field of 60. Returns:boolean true if this instant is within a leap second

isLeapSecond

back to summary

public boolean isLeapSecond()

Checks if the instant is within a leap second.

This method returns true when an accurate clock would return a seconds field of 60.

Returns:boolean: true if this instant is within a leap second

minus back to summary

minus	back to summary
public UtcInstant minus(Duration duration) Returns a copy of this instant with the specified duration subtracted. The duration is subtracted using simple subtraction of the seconds and nanoseconds in the duration from the seconds and nanoseconds of this instant. As a result, the duration is treated as being measured in TAI compatible seconds for the purpose of this method. This instance is immutable and unaffected by this method call. Parameters duration:Duration the duration to subtract, not null Returns:UtcInstant a `UtcInstant` with the duration subtracted, not null Exceptions ArithmeticException: if the calculation exceeds the supported range

public UtcInstant minus(Duration duration)

Returns a copy of this instant with the specified duration subtracted.

The duration is subtracted using simple subtraction of the seconds and nanoseconds in the duration from the seconds and nanoseconds of this instant. As a result, the duration is treated as being measured in TAI compatible seconds for the purpose of this method.

This instance is immutable and unaffected by this method call.

Parameters

duration:Duration: the duration to subtract, not null

Returns:UtcInstant

a UtcInstant with the duration subtracted, not null

Exceptions

ArithmeticException:: if the calculation exceeds the supported range

of back to summary

of	back to summary
public static UtcInstant of(Instant instant) Obtains an instance of `UtcInstant` from an `Instant`. Converting a UTC-SLS instant to UTC requires leap second rules. This method uses the latest available system rules. Conversion from an `Instant` will not be completely accurate near a leap second in accordance with UTC-SLS. Parameters instant:Instant the instant to convert, not null Returns:UtcInstant the UTC instant, not null Exceptions DateTimeException: if the range of `UtcInstant` is exceeded ArithmeticException: if numeric overflow occurs

public static UtcInstant of(Instant instant)

Obtains an instance of UtcInstant from an Instant.

Converting a UTC-SLS instant to UTC requires leap second rules. This method uses the latest available system rules.

Conversion from an Instant will not be completely accurate near a leap second in accordance with UTC-SLS.

Parameters

instant:Instant: the instant to convert, not null

Returns:UtcInstant

the UTC instant, not null

Exceptions

DateTimeException:: if the range of UtcInstant is exceeded
ArithmeticException:: if numeric overflow occurs

of back to summary

of	back to summary
public static UtcInstant of(TaiInstant instant) Obtains an instance of `UtcInstant` from a `TaiInstant`. Converting a TAI instant to UTC requires leap second rules. This method uses the latest available system rules. The `UtcInstant` will represent exactly the same point on the time-line as per the available leap-second rules. If the leap-second rules change then conversion back to TAI may result in a different instant. Parameters instant:TaiInstant the instant to convert, not null Returns:UtcInstant the UTC instant, not null Exceptions DateTimeException: if the range of `UtcInstant` is exceeded ArithmeticException: if numeric overflow occurs

public static UtcInstant of(TaiInstant instant)

Obtains an instance of UtcInstant from a TaiInstant.

Converting a TAI instant to UTC requires leap second rules. This method uses the latest available system rules.

The UtcInstant will represent exactly the same point on the time-line as per the available leap-second rules. If the leap-second rules change then conversion back to TAI may result in a different instant.

Parameters

instant:TaiInstant: the instant to convert, not null

Returns:UtcInstant

the UTC instant, not null

Exceptions

DateTimeException:: if the range of UtcInstant is exceeded
ArithmeticException:: if numeric overflow occurs

ofModifiedJulianDay back to summary

ofModifiedJulianDay	back to summary
public static UtcInstant ofModifiedJulianDay(long mjDay, long nanoOfDay) Obtains an instance of `UtcInstant` from a Modified Julian Day with a nanosecond fraction of day. Modified Julian Day is a simple incrementing count of days where day 0 is 1858-11-17. Nanosecond-of-day is a simple count of nanoseconds from the start of the day including any additional leap-second. This method validates the nanosecond-of-day value against the Modified Julian Day. The nanosecond-of-day value has a valid range from `0` to `86,400,000,000,000 - 1` on most days, and a larger or smaller range on leap-second days. The nanosecond value must be positive even for negative values of Modified Julian Day. One nanosecond before Modified Julian Day zero will be `-1` days and the maximum nanosecond value. Parameters mjDay:long the date as a Modified Julian Day (number of days from the epoch of 1858-11-17) nanoOfDay:long the nanoseconds within the day, including leap seconds Returns:UtcInstant the UTC instant, not null Exceptions IllegalArgumentException: if nanoOfDay is out of range

public static UtcInstant ofModifiedJulianDay(long mjDay, long nanoOfDay)

Obtains an instance of UtcInstant from a Modified Julian Day with a nanosecond fraction of day.

Modified Julian Day is a simple incrementing count of days where day 0 is 1858-11-17. Nanosecond-of-day is a simple count of nanoseconds from the start of the day including any additional leap-second. This method validates the nanosecond-of-day value against the Modified Julian Day.

The nanosecond-of-day value has a valid range from 0 to 86,400,000,000,000 - 1 on most days, and a larger or smaller range on leap-second days.

The nanosecond value must be positive even for negative values of Modified Julian Day. One nanosecond before Modified Julian Day zero will be -1 days and the maximum nanosecond value.

Parameters

mjDay:long: the date as a Modified Julian Day (number of days from the epoch of 1858-11-17)
nanoOfDay:long: the nanoseconds within the day, including leap seconds

Returns:UtcInstant

the UTC instant, not null

Exceptions

IllegalArgumentException:: if nanoOfDay is out of range

parse back to summary

parse	back to summary
public static UtcInstant parse(CharSequence text) Obtains an instance of `UtcInstant` from a text string, such as `2007-12-03T10:15:30.00Z`. The string must represent a valid instant in UTC and is parsed using `DateTimeFormatter#ISO_INSTANT` with leap seconds handled. Parameters text:CharSequence the text to parse such as "2007-12-03T10:15:30.00Z", not null Returns:UtcInstant the parsed instant, not null Annotations @FromString Exceptions DateTimeParseException: if the text cannot be parsed DateTimeException: if parsed text represents an invalid leap second

public static UtcInstant parse(CharSequence text)

Obtains an instance of UtcInstant from a text string, such as 2007-12-03T10:15:30.00Z.

The string must represent a valid instant in UTC and is parsed using DateTimeFormatter#ISO_INSTANT with leap seconds handled.

Parameters

text:CharSequence: the text to parse such as "2007-12-03T10:15:30.00Z", not null

Returns:UtcInstant

the parsed instant, not null

Annotations

@FromString

Exceptions

DateTimeParseException:: if the text cannot be parsed
DateTimeException:: if parsed text represents an invalid leap second

plus back to summary

plus	back to summary
public UtcInstant plus(Duration duration) Returns a copy of this instant with the specified duration added. The duration is added using simple addition of the seconds and nanoseconds in the duration to the seconds and nanoseconds of this instant. As a result, the duration is treated as being measured in TAI compatible seconds for the purpose of this method. This instance is immutable and unaffected by this method call. Parameters duration:Duration the duration to add, not null Returns:UtcInstant a `UtcInstant` with the duration added, not null Exceptions ArithmeticException: if the calculation exceeds the supported range

public UtcInstant plus(Duration duration)

Returns a copy of this instant with the specified duration added.

The duration is added using simple addition of the seconds and nanoseconds in the duration to the seconds and nanoseconds of this instant. As a result, the duration is treated as being measured in TAI compatible seconds for the purpose of this method.

This instance is immutable and unaffected by this method call.

Parameters

duration:Duration: the duration to add, not null

Returns:UtcInstant

a UtcInstant with the duration added, not null

Exceptions

ArithmeticException:: if the calculation exceeds the supported range

toInstant back to summary

toInstant	back to summary
public Instant toInstant() Converts this instant to an `Instant`. Converting a UTC instant to UTC-SLS requires leap second rules. This method uses the latest available system rules. Conversion to an `Instant` will not be completely accurate near a leap second in accordance with UTC-SLS. Returns:Instant an `Instant` representing the best approximation of this instant, not null Exceptions DateTimeException: if the range of `Instant` is exceeded ArithmeticException: if numeric overflow occurs

public Instant toInstant()

Converts this instant to an Instant.

Converting a UTC instant to UTC-SLS requires leap second rules. This method uses the latest available system rules.

Conversion to an Instant will not be completely accurate near a leap second in accordance with UTC-SLS.

Returns:Instant

an Instant representing the best approximation of this instant, not null

Exceptions

DateTimeException:: if the range of Instant is exceeded
ArithmeticException:: if numeric overflow occurs

toString	back to summary
public String toString() Overrides java.lang.Object.toString. A string representation of this instant. The string is formatted using ISO-8601. The output includes seconds, 9 nanosecond digits and a trailing 'Z'. The time-of-day will be 23:59:60 during a positive leap second. Returns:String a representation of this instant, not null Annotations @Override @ToString

toString

back to summary

public String toString()

Overrides java.lang.Object.toString.

A string representation of this instant.

The string is formatted using ISO-8601. The output includes seconds, 9 nanosecond digits and a trailing 'Z'. The time-of-day will be 23:59:60 during a positive leap second.

Returns:String

a representation of this instant, not null

Annotations

@Override
@ToString

toTaiInstant back to summary

toTaiInstant	back to summary
public TaiInstant toTaiInstant() Converts this instant to a `TaiInstant`. Converting a UTC instant to TAI requires leap second rules. This method uses the latest available system rules. The `TaiInstant` will represent exactly the same point on the time-line as per the available leap-second rules. If the leap-second rules change then conversion back to UTC may result in a different instant. Returns:TaiInstant a `TaiInstant` representing the same instant, not null Exceptions DateTimeException: if the range of `TaiInstant` is exceeded ArithmeticException: if numeric overflow occurs

public TaiInstant toTaiInstant()

Converts this instant to a TaiInstant.

Converting a UTC instant to TAI requires leap second rules. This method uses the latest available system rules.

The TaiInstant will represent exactly the same point on the time-line as per the available leap-second rules. If the leap-second rules change then conversion back to UTC may result in a different instant.

Returns:TaiInstant

a TaiInstant representing the same instant, not null

Exceptions

DateTimeException:: if the range of TaiInstant is exceeded
ArithmeticException:: if numeric overflow occurs

withModifiedJulianDay back to summary

withModifiedJulianDay	back to summary
public UtcInstant withModifiedJulianDay(long mjDay) Returns a copy of this `UtcInstant` with the Modified Julian Day (MJD) altered. The Modified Julian Day is a simple incrementing count of days where day 0 is 1858-11-17. The nanosecond part of the day is returned by `getNanosOfDay`. The day varies in length, being one second longer on a leap day. This instance is immutable and unaffected by this method call. Parameters mjDay:long the date as a Modified Julian Day (number of days from the epoch of 1858-11-17) Returns:UtcInstant a `UtcInstant` based on this instant with the requested day, not null Exceptions DateTimeException: if nanoOfDay becomes invalid

public UtcInstant withModifiedJulianDay(long mjDay)

Returns a copy of this UtcInstant with the Modified Julian Day (MJD) altered.

This instance is immutable and unaffected by this method call.

Parameters

mjDay:long: the date as a Modified Julian Day (number of days from the epoch of 1858-11-17)

Returns:UtcInstant

a UtcInstant based on this instant with the requested day, not null

Exceptions

DateTimeException:: if nanoOfDay becomes invalid

withNanoOfDay back to summary

withNanoOfDay	back to summary
public UtcInstant withNanoOfDay(long nanoOfDay) Returns a copy of this `UtcInstant` with the nano-of-day altered. The nanosecond-of-day value measures the total number of nanoseconds within the day from the start of the day returned by `getModifiedJulianDay`. This value will include any additional leap seconds. This instance is immutable and unaffected by this method call. Parameters nanoOfDay:long the nanoseconds within the day, including leap seconds Returns:UtcInstant a `UtcInstant` based on this instant with the requested nano-of-day, not null Exceptions DateTimeException: if the nanoOfDay value is invalid

public UtcInstant withNanoOfDay(long nanoOfDay)

Returns a copy of this UtcInstant with the nano-of-day altered.

The nanosecond-of-day value measures the total number of nanoseconds within the day from the start of the day returned by getModifiedJulianDay. This value will include any additional leap seconds.

This instance is immutable and unaffected by this method call.

Parameters

nanoOfDay:long: the nanoseconds within the day, including leap seconds

Returns:UtcInstant

a UtcInstant based on this instant with the requested nano-of-day, not null

Exceptions

DateTimeException:: if the nanoOfDay value is invalid

public final Class UtcInstant

Time-scale

Implementation Requirements:

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail