10:15:30+01:00.
OffsetTime is an immutable date-time object that represents a time, often
viewed as hour-minute-second-offset.
This class stores all time fields, to a precision of nanoseconds,
as well as a zone offset.
For example, the value "13:45:30.123456789+02:00" can be stored
in an OffsetTime.
This is a value-based
class; programmers should treat instances that are
equal as interchangeable and should not
use instances for synchronization, or unpredictable behavior may
occur. For example, in a future release, synchronization may fail.
The equals method should be used for comparisons.
Implementation Specification
This class is immutable and thread-safe.
| Modifier and Type | Field and Description |
|---|---|
| public static final OffsetTime | MAX
The maximum supported |
| public static final OffsetTime | MIN
The minimum supported |
| private final ZoneOffset | |
| private static final long | serialVersionUID
Serialization version. |
| private final LocalTime |
| Access | Constructor and Description |
|---|---|
| private | OffsetTime(LocalTime
the local time, not null time, ZoneOffset the zone offset, not null offset)Constructor. |
| Modifier and Type | Method and Description |
|---|---|
| public Temporal | Returns: the adjusted object, not nullthe target object to be adjusted, not null temporal)Implements java. Adjusts the specified temporal object to have the same offset and time as this object. |
| public OffsetDateTime | |
| public int | Returns: the comparator value, that is the comparison of the UTC equivalentother instant,
if they are not equal, and if the UTC equivalent other instant is equal,
the comparison of this local time with other local timethe other time to compare to, not null other)Implements java. Compares this |
| public boolean | Returns: true if this is equal to the other timethe object to check, null returns false obj)Overrides java. Checks if this time is equal to another time. |
| public String | Returns: the formatted time string, not nullthe formatter to use, not null formatter)Formats this time using the specified formatter. |
| public static OffsetTime | Returns: the offset time, not nullthe temporal object to convert, not null temporal)Obtains an instance of |
| public int | Returns: the value for the fieldthe field to get, not null field)Overrides default java. Gets the value of the specified field from this time as an |
| public int | |
| public long | Returns: the value for the fieldthe field to get, not null field)Implements java. Gets the value of the specified field from this time as a |
| public int | |
| public int | |
| public ZoneOffset | |
| public int | |
| public int | Returns: a suitable hash codeOverrides java. A hash code for this time. |
| public boolean | Returns: true if this is after the instant of the specified timethe other time to compare to, not null other)Checks if the instant of this |
| public boolean | Returns: true if this is before the instant of the specified timethe other time to compare to, not null other)Checks if the instant of this |
| public boolean | Returns: true if this is equal to the instant of the specified timethe other time to compare to, not null other)Checks if the instant of this |
| public boolean | Returns: true if the field is supported on this time, false if notthe field to check, null returns false field)Implements java. Checks if the specified field is supported. |
| public boolean | Returns: true if the unit can be added/subtracted, false if notthe unit to check, null returns false unit)Implements java. Checks if the specified unit is supported. |
| public OffsetTime | Returns: anOffsetTime based on this time with the subtraction made, not nullthe amount to subtract, not null amountToSubtract)Overrides default java. Returns a copy of this time with the specified amount subtracted. |
| public OffsetTime | Returns: anOffsetTime based on this time with the specified amount subtracted, not nullthe amount of the unit to subtract from the result, may be negative amountToSubtract, TemporalUnit the unit of the amount to subtract, not null unit)Overrides default java. Returns a copy of this time with the specified amount subtracted. |
| public OffsetTime | Returns: anOffsetTime based on this time with the hours subtracted, not nullthe hours to subtract, may be negative hours)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the minutes subtracted, not nullthe minutes to subtract, may be negative minutes)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the nanoseconds subtracted, not nullthe nanos to subtract, may be negative nanos)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the seconds subtracted, not nullthe seconds to subtract, may be negative seconds)Returns a copy of this |
| public static OffsetTime | Returns: the current time using the system clock and default time-zone, not nullObtains the current time from the system clock in the default time-zone. |
| public static OffsetTime | |
| public static OffsetTime | |
| public static OffsetTime | Returns: the offset time, not nullthe local time, not null time, ZoneOffset the zone offset, not null offset)Obtains an instance of |
| public static OffsetTime | Returns: the offset time, not nullthe hour-of-day to represent, from 0 to 23 hour, int the minute-of-hour to represent, from 0 to 59 minute, int the second-of-minute to represent, from 0 to 59 second, int the nano-of-second to represent, from 0 to 999,999,999 nanoOfSecond, ZoneOffset the zone offset, not null offset)Obtains an instance of |
| public static OffsetTime | |
| public static OffsetTime | Returns: the parsed local time, not nullthe text to parse such as "10:15:30+01:00", not null text)Obtains an instance of |
| public static OffsetTime | Returns: the parsed offset time, not nullthe text to parse, not null text, DateTimeFormatter the formatter to use, not null formatter)Obtains an instance of |
| public OffsetTime | Returns: anOffsetTime based on this time with the addition made, not nullthe amount to add, not null amountToAdd)Overrides default java. Returns a copy of this time with the specified amount added. |
| public OffsetTime | Returns: anOffsetTime based on this time with the specified amount added, not nullthe amount of the unit to add to the result, may be negative amountToAdd, TemporalUnit the unit of the amount to add, not null unit)Implements java. Returns a copy of this time with the specified amount added. |
| public OffsetTime | Returns: anOffsetTime based on this time with the hours added, not nullthe hours to add, may be negative hours)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the minutes added, not nullthe minutes to add, may be negative minutes)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the nanoseconds added, not nullthe nanos to add, may be negative nanos)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the seconds added, not nullthe seconds to add, may be negative seconds)Returns a copy of this |
| public < the type of the result R> R | Returns: the query result, null may be returned (defined by the query)the query to invoke, not null query)Overrides default java. Queries this time using the specified query. |
| public ValueRange | Returns: the range of valid values for the field, not nullthe field to query the range for, not null field)Overrides default java. Gets the range of valid values for the specified field. |
| pack-priv static OffsetTime | |
| private void | |
| private long | |
| public long | Returns: the number of seconds since the epoch of 1970-01-01T00:00:00Z, may be negativethe localdate, not null date)Converts this |
| public LocalTime | Returns: the time part of this date-time, not nullGets the |
| public String | Returns: a string representation of this time, not nullOverrides java. Outputs this time as a |
| public OffsetTime | Returns: anOffsetTime based on this time with the time truncated, not nullthe unit to truncate to, not null unit)Returns a copy of this |
| public long | Returns: the amount of time between this time and the end timethe end time, exclusive, which is converted to an endExclusive, TemporalUnit OffsetTime, not nullthe unit to measure the amount in, not null unit)Implements java. Calculates the amount of time until another time in terms of the specified unit. |
| private OffsetTime | with(LocalTime
the time to create with, not null time, ZoneOffset the zone offset to create with, not null offset)Returns a new time based on this one, returning |
| public OffsetTime | Returns: anOffsetTime based on this with the adjustment made, not nullthe adjuster to use, not null adjuster)Overrides default java. Returns an adjusted copy of this time. |
| public OffsetTime | Returns: anOffsetTime based on this with the specified field set, not nullthe field to set in the result, not null field, long the new value of the field in the result newValue)Implements java. Returns a copy of this time with the specified field set to a new value. |
| public OffsetTime | Returns: anOffsetTime based on this time with the requested hour, not nullthe hour-of-day to set in the result, from 0 to 23 hour)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the requested minute, not nullthe minute-of-hour to set in the result, from 0 to 59 minute)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the requested nanosecond, not nullthe nano-of-second to set in the result, from 0 to 999,999,999 nanoOfSecond)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the requested offset, not nullthe zone offset to change to, not null offset)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the requested offset, not nullthe zone offset to change to, not null offset)Returns a copy of this |
| public OffsetTime | Returns: anOffsetTime based on this time with the requested second, not nullthe second-of-minute to set in the result, from 0 to 59 second)Returns a copy of this |
| pack-priv void | |
| private Object | Returns: the instance ofSer, not nullWrites the object using a dedicated serialized form. |