OffsetDateTime
Related Docs:
class OffsetDateTime
| package bp
The maximum supported OffsetDateTime, '+999999999-12-31T23:59:59.999999999-18:00'.
The maximum supported OffsetDateTime, '+999999999-12-31T23:59:59.999999999-18:00'.
This is the local date-time just before midnight at the end of the maximum date
in the minimum offset (larger negative offsets are later on the time-line).
This combines LocalDateTime#MAX and ZoneOffset#MIN.
This could be used by an application as a "far future" date-time.
The minimum supported OffsetDateTime, '-999999999-01-01T00:00:00+18:00'.
The minimum supported OffsetDateTime, '-999999999-01-01T00:00:00+18:00'.
This is the local date-time of midnight at the start of the minimum date
in the maximum offset (larger offsets are earlier on the time-line).
This combines LocalDateTime#MIN and ZoneOffset#MAX.
This could be used by an application as a "far past" date-time.
Obtains an instance of OffsetDateTime from a temporal object.
Obtains an instance of OffsetDateTime from a temporal object.
A TemporalAccessor represents some form of date and time information.
This factory converts the arbitrary temporal object to an instance of OffsetDateTime.
The conversion extracts and combines LocalDateTime and ZoneOffset.
If that fails it will try to extract and combine Instant and ZoneOffset.
This method matches the signature of the functional interface TemporalQuery
allowing it to be used in queries via method reference, OffsetDateTime::from.
the temporal object to convert, not null
the offset date-time, not null
DateTimeException if unable to convert to an { @code OffsetDateTime}
Obtains the current date-time from the specified clock.
Obtains the current date-time from the specified clock.
This will query the specified clock to obtain the current date-time. The offset will be calculated from the time-zone in the clock.
Using this method allows the use of an alternate clock for testing.
The alternate clock may be introduced using dependency injection.
the clock to use, not null
the current date-time, not null
Obtains the current date-time from the system clock in the specified time-zone.
Obtains the current date-time from the system clock in the specified time-zone.
This will query the system clock to obtain the current date-time.
Specifying the time-zone avoids dependence on the default time-zone.
The offset will be calculated from the specified time-zone.
Using this method will prevent the ability to use an alternate clock for testing because the clock is hard-coded.
the zone ID to use, not null
the current date-time using the system clock, not null
Obtains the current date-time from the system clock in the default time-zone.
Obtains the current date-time from the system clock in the default time-zone.
This will query the system clock in the default
time-zone to obtain the current date-time.
The offset will be calculated from the time-zone in the clock.
Using this method will prevent the ability to use an alternate clock for testing because the clock is hard-coded.
the current date-time using the system clock, not null
Obtains an instance of OffsetDateTime from a year, month, day,
hour, minute, second, nanosecond and offset.
Obtains an instance of OffsetDateTime from a year, month, day,
hour, minute, second, nanosecond and offset.
This creates an offset date-time with the seven specified fields.
This method exists primarily for writing test cases.
Non test-code will typically use other methods to create an offset time.
LocalDateTime has five additional convenience variants of the
equivalent factory method taking fewer arguments.
They are not provided here to reduce the footprint of the API.
the year to represent, from MIN_YEAR to MAX_YEAR
the month-of-year to represent, from 1 (January) to 12 (December)
the day-of-month to represent, from 1 to 31
the hour-of-day to represent, from 0 to 23
the minute-of-hour to represent, from 0 to 59
the second-of-minute to represent, from 0 to 59
the nano-of-second to represent, from 0 to 999,999,999
the zone offset, not null
the offset date-time, not null
DateTimeException if the value of any field is out of range, or
if the day-of-month is invalid for the month-year
Obtains an instance of OffsetDateTime from a date-time and offset.
Obtains an instance of OffsetDateTime from a date-time and offset.
This creates an offset date-time with the specified local date-time and offset.
the local date-time, not null
the zone offset, not null
the offset date-time, not null
Obtains an instance of OffsetDateTime from a date, time and offset.
Obtains an instance of OffsetDateTime from a date, time and offset.
This creates an offset date-time with the specified local date, time and offset.
the local date, not null
the local time, not null
the zone offset, not null
the offset date-time, not null
Obtains an instance of OffsetDateTime from an Instant and zone ID.
Obtains an instance of OffsetDateTime from an Instant and zone ID.
This creates an offset date-time with the same instant as that specified. Finding the offset from UTC/Greenwich is simple as there is only one valid offset for each instant.
the instant to create the date-time from, not null
the time-zone, which may be an offset, not null
the offset date-time, not null
DateTimeException if the result exceeds the supported range
Obtains an instance of OffsetDateTime from a text string using a specific formatter.
Obtains an instance of OffsetDateTime from a text string using a specific formatter.
The text is parsed using the formatter, returning a date-time.
the text to parse, not null
the formatter to use, not null
the parsed offset date-time, not null
DateTimeParseException if the text cannot be parsed
Obtains an instance of OffsetDateTime from a text string
such as 2007-12-03T10:15:30+01:00.
Obtains an instance of OffsetDateTime from a text string
such as 2007-12-03T10:15:30+01:00.
The string must represent a valid date-time and is parsed using
org.threeten.bp.format.DateTimeFormatter#ISO_OFFSET_DATE_TIME.
the text to parse such as "2007-12-03T10:15:30+01:00", not null
the parsed offset date-time, not null
DateTimeParseException if the text cannot be parsed
Gets a comparator that compares two OffsetDateTime instances
based solely on the instant.
Gets a comparator that compares two OffsetDateTime instances
based solely on the instant.
This method differs from the comparison in #compareTo in that it
only compares the underlying instant.
a comparator that compares in time-line order
#isEqual
#isBefore
#isAfter