Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class OffsetTime extends Object implements Temporal, TemporalAdjuster, Comparable<OffsetTime>, Serializable
10:15:30+01:00
.
OffsetTime
неизменный разовый датой объект, который представляет время, часто просматриваемое как "минута часа второе смещение". Этот class хранит все поля времени к точности наносекунд, так же как зональному смещению. Например, значение "13:45.30.123456789+02:00" может быть сохранено в OffsetTime
.
Модификатор и Тип | Поле и Описание |
---|---|
static OffsetTime |
МАКСИМАЛЬНЫЙ
Максимум поддерживается
OffsetTime , '23:59:59.999999999-18:00'. |
static OffsetTime |
МИН
Минимум поддерживается
OffsetTime , '00:00:00+18:00'. |
Модификатор и Тип | Метод и Описание |
---|---|
Временный |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь то же самое смещение и время как этот объект.
|
OffsetDateTime |
atDate(LocalDate date)
Объединяется на сей раз с датой, чтобы создать
OffsetDateTime . |
int |
compareTo(OffsetTime other)
Сравнивает это
OffsetTime к другому времени. |
boolean |
equals(Object obj)
Проверки, если это время равно другому времени.
|
Строка |
format(DateTimeFormatter formatter)
Форматы на сей раз, используя указанное средство форматирования.
|
static OffsetTime |
from(TemporalAccessor temporal)
Получает экземпляр
OffsetTime от временного объекта. |
int |
get(TemporalField field)
Получает значение указанного поля с этого времени как
int . |
int |
getHour()
Получает поле часа-дневного.
|
long |
getLong(TemporalField field)
Получает значение указанного поля с этого времени как a
long . |
int |
getMinute()
Получает мелкое-часового поле.
|
int |
getNano()
Получает nano-of-second поле.
|
ZoneOffset |
getOffset()
Получает зональное смещение, такое как '+01:00'.
|
int |
getSecond()
Получает второе-минутного поле.
|
int |
hashCode()
Хэш-код в течение этого времени.
|
boolean |
isAfter(OffsetTime other)
Проверки, если момент этого
OffsetTime после того из требуемого времени, применяясь оба раза к общей дате. |
boolean |
isBefore(OffsetTime other)
Проверки, если момент этого
OffsetTime перед тем из требуемого времени, применяясь оба раза к общей дате. |
boolean |
isEqual(OffsetTime other)
Проверки, если момент этого
OffsetTime равно тому из требуемого времени, применяясь оба раза к общей дате. |
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
OffsetTime |
minus(long amountToSubtract, TemporalUnit unit)
Возвращает копию этого времени с указанным вычтенным количеством.
|
OffsetTime |
minus(TemporalAmount amountToSubtract)
Возвращает копию этого времени с указанным вычтенным количеством.
|
OffsetTime |
minusHours(long hours)
Возвращает копию этого
OffsetTime с установленным периодом в вычтенных часах. |
OffsetTime |
minusMinutes(long minutes)
Возвращает копию этого
OffsetTime с установленным периодом в вычтенных минутах. |
OffsetTime |
minusNanos(long nanos)
Возвращает копию этого
OffsetTime с установленным периодом в вычтенных наносекундах. |
OffsetTime |
minusSeconds(long seconds)
Возвращает копию этого
OffsetTime с установленным периодом в вычтенных секундах. |
static OffsetTime |
now()
Получает текущее время из системных часов в часовом поясе значения по умолчанию.
|
static OffsetTime |
now(Clock clock)
Получает текущее время из указанных часов.
|
static OffsetTime |
now(ZoneId zone)
Получает текущее время из системных часов в указанном часовом поясе.
|
static OffsetTime |
of(int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset)
Получает экземпляр
OffsetTime с часа, минуты, второй и наносекунда. |
static OffsetTime |
of(LocalTime time, ZoneOffset offset)
Получает экземпляр
OffsetTime с местного времени и смещения. |
static OffsetTime |
ofInstant(Instant instant, ZoneId zone)
Получает экземпляр
OffsetTime от Instant и зональный ID. |
static OffsetTime |
parse(CharSequence text)
Получает экземпляр
OffsetTime от текстовой строки такой как 10:15:30+01:00 . |
static OffsetTime |
parse(CharSequence text, DateTimeFormatter formatter)
Получает экземпляр
OffsetTime от текстовой строки, используя определенное средство форматирования. |
long |
periodUntil(Temporal endTime, TemporalUnit unit)
Вычисляет количество времени до другого времени с точки зрения указанного модуля.
|
OffsetTime |
plus(long amountToAdd, TemporalUnit unit)
Возвращает копию этого времени с указанным добавленным количеством.
|
OffsetTime |
plus(TemporalAmount amountToAdd)
Возвращает копию этого времени с указанным добавленным количеством.
|
OffsetTime |
plusHours(long hours)
Возвращает копию этого
OffsetTime с установленным периодом в добавленных часах. |
OffsetTime |
plusMinutes(long minutes)
Возвращает копию этого
OffsetTime с установленным периодом в добавленных минутах. |
OffsetTime |
plusNanos(long nanos)
Возвращает копию этого
OffsetTime с установленным периодом в добавленных наносекундах. |
OffsetTime |
plusSeconds(long seconds)
Возвращает копию этого
OffsetTime с установленным периодом в добавленных секундах. |
<R> R |
query(TemporalQuery<R> query)
Запросы на сей раз, используя указанный запрос.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
LocalTime |
toLocalTime()
Добирается
LocalTime часть этого разового датой. |
Строка |
toString()
Выводы на сей раз как a
String , такой как 10:15:30+01:00 . |
OffsetTime |
truncatedTo(TemporalUnit unit)
Возвращает копию этого
OffsetTime с усеченным временем. |
OffsetTime |
with(TemporalAdjuster adjuster)
Возвращает скорректированную копию этого времени.
|
OffsetTime |
with(TemporalField field, long newValue)
Возвращает копию этого времени с указанным полевым набором к новому значению.
|
OffsetTime |
withHour(int hour)
Возвращает копию этого
OffsetTime с измененным значением часа-дневного. |
OffsetTime |
withMinute(int minute)
Возвращает копию этого
OffsetTime с мелким-часового измененным значением. |
OffsetTime |
withNano(int nanoOfSecond)
Возвращает копию этого
OffsetTime с измененным значением nano-of-second. |
OffsetTime |
withOffsetSameInstant(ZoneOffset offset)
Возвращает копию этого
OffsetTime с указанным смещением, гарантирующим, что результат в тот же самый момент в подразумеваемый день. |
OffsetTime |
withOffsetSameLocal(ZoneOffset offset)
Возвращает копию этого
OffsetTime с указанным смещением, гарантирующим, что у результата есть то же самое местное время. |
OffsetTime |
withSecond(int second)
Возвращает копию этого
OffsetTime со вторым-минутного измененным значением. |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static final OffsetTime MIN
OffsetTime
, '0:00:00 +18:00'. Это - время полуночи в начале дня в максимальном смещении (большие смещения являются раньше временной шкалой). Это объединяется LocalTime.MIN
и ZoneOffset.MAX
. Это могло использоваться приложением в качестве "далекой прошлой" даты.public static final OffsetTime MAX
OffsetTime
, '23:59:59.999999999-18:00'. Это - время как раз перед полуночью в конце дня в минимальном смещении (большие отрицательные смещения являются позже временной шкалой). Это объединяется LocalTime.MAX
и ZoneOffset.MIN
. Это могло использоваться приложением в качестве "далекой будущей" даты.public static OffsetTime now()
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущее время. Смещение будет вычислено от часового пояса в часах.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static OffsetTime now(ZoneId zone)
Это запросит system clock
получить текущее время. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию. Смещение будет вычислено от указанного часового пояса.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static OffsetTime now(Clock clock)
Это запросит указанные часы, чтобы получить текущее время. Смещение будет вычислено от часового пояса в часах.
Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
clock
- часы, чтобы использовать, не нульpublic static OffsetTime of(LocalTime time, ZoneOffset offset)
OffsetTime
с местного времени и смещения.time
- местное время, не нульoffset
- зональное смещение, не нульpublic static OffsetTime of(int hour, int minute, int second, int nanoOfSecond, ZoneOffset offset)
OffsetTime
с часа, минуты, второй и наносекунда. Это создает время смещения с четырьмя указанными полями.
Этот метод существует прежде всего для того, чтобы записать прецеденты. Не тестовый код будет обычно использовать другие методы, чтобы создать время смещения. LocalTime
имеет две дополнительных разновидности удобства эквивалентного метода фабрики, берущего меньше параметров. Им не обеспечивают здесь, чтобы уменьшить место API.
hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59nanoOfSecond
- nano-of-second, чтобы представить, от 0 до 999 999 999offset
- зональное смещение, не нульDateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic static OffsetTime ofInstant(Instant instant, ZoneId zone)
OffsetTime
от Instant
и зональный ID. Это создает время смещения с тем же самым моментом, как это определило. Обнаружение смещения от UTC/Гринвича просто, поскольку есть только одно допустимое смещение в течение каждого момента.
Компонент даты момента отбрасывается во время преобразования. Это означает, что преобразование никогда не может перестать работать из-за момента, испытывая недостаток допустимого диапазона дат.
instant
- момент, чтобы создать время из, не нульzone
- часовой пояс, который может быть смещением, не нулемpublic static OffsetTime from(TemporalAccessor temporal)
OffsetTime
от временного объекта. Это получает время смещения, основанное на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр OffsetTime
.
Преобразование извлекает и объединяется ZoneOffset
и LocalTime
от временного объекта. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в запросах через ссылку метода, OffsetTime::from
.
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в OffsetTime
public static OffsetTime parse(CharSequence text)
OffsetTime
от текстовой строки такой как 10:15:30+01:00
. Строка должна представить допустимое время и анализируется, используя DateTimeFormatter.ISO_OFFSET_TIME
.
text
- текст, чтобы проанализировать, такие как "10:15:30 +01:00", не нульDateTimeParseException
- если текст не может быть проанализированpublic static OffsetTime parse(CharSequence text, DateTimeFormatter formatter)
OffsetTime
от текстовой строки, используя определенное средство форматирования. Текст анализируется, используя средство форматирования, возвращая время.
text
- текст, чтобы проанализировать, не нульformatter
- средство форматирования, чтобы использовать, не нульDateTimeParseException
- если текст не может быть проанализированpublic boolean isSupported(TemporalField field)
Это проверяет, может ли это время быть запрошено для указанного поля. Если ложь, то вызов range
и get
методы выдадут исключение.
Если поле является a ChronoField
тогда запрос реализуется здесь. Поддерживаемые поля:
NANO_OF_SECOND
NANO_OF_DAY
MICRO_OF_SECOND
MICRO_OF_DAY
MILLI_OF_SECOND
MILLI_OF_DAY
SECOND_OF_MINUTE
SECOND_OF_DAY
MINUTE_OF_HOUR
MINUTE_OF_DAY
HOUR_OF_AMPM
CLOCK_HOUR_OF_AMPM
HOUR_OF_DAY
CLOCK_HOUR_OF_DAY
AMPM_OF_DAY
OFFSET_SECONDS
ChronoField
экземпляры возвратят false. Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor)
передача this
как параметр. Поддерживается ли поле, определяется полем.
isSupported
в интерфейсе TemporalAccessor
field
- поле, чтобы проверить, обнулите, возвращает falsepublic ValueRange range(TemporalField field)
Объект диапазона выражает минимальные и максимальные допустимые значения для поля. Это время используется, чтобы улучшить точность возвращенного диапазона. Если не возможно возвратить диапазон, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит соответствующие экземпляры диапазона. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.rangeRefinedBy(TemporalAccessor)
передача this
как параметр. Может ли диапазон быть получен, определяется полем.
range
в интерфейсе TemporalAccessor
field
- поле, чтобы запросить диапазон для, не нульDateTimeException
- если диапазон для поля не может быть полученUnsupportedTemporalTypeException
- если поле не поддерживаетсяpublic int get(TemporalField field)
int
. Это запрашивает на сей раз для значения для указанного поля. Возвращенное значение всегда будет в пределах допустимого диапазона значений для поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит допустимые значения, основанные на этом времени, кроме NANO_OF_DAY
и MICRO_OF_DAY
которые являются слишком большими, чтобы вписаться int
и бросок a DateTimeException
. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
get
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть получено, или значение вне диапазона допустимых значений для поляUnsupportedTemporalTypeException
- если поле не поддерживается, или диапазон значений превышает int
ArithmeticException
- если числовое переполнение происходитpublic long getLong(TemporalField field)
long
. Это запрашивает на сей раз для значения для указанного поля. Если не возможно возвратить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда запрос реализуется здесь. supported fields
возвратит допустимые значения, основанные на этом времени. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.getFrom(TemporalAccessor)
передача this
как параметр. Может ли значение быть получено, и что представляет значение, определяется полем.
getLong
в интерфейсе TemporalAccessor
field
- поле, чтобы получить, не нульDateTimeException
- если значение для поля не может быть полученоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic ZoneOffset getOffset()
Это - смещение местного времени от UTC/Гринвича.
public OffsetTime withOffsetSameLocal(ZoneOffset offset)
OffsetTime
с указанным смещением, гарантирующим, что у результата есть то же самое местное время. Этот метод возвращает объект с тем же самым LocalTime
и указанное ZoneOffset
. Никакое вычисление не необходимо или выполняется. Например, если на сей раз представляет 10:30+02:00
и определенное смещение +03:00
, тогда этот метод возвратится 10:30+03:00
.
Принять во внимание различие между смещениями, и скорректировать поля времени, использование withOffsetSameInstant(java.time.ZoneOffset)
.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
offset
- зональное смещение, чтобы изменить на, не нульOffsetTime
основанный на этом времени с требуемым смещением, не нулеpublic OffsetTime withOffsetSameInstant(ZoneOffset offset)
OffsetTime
с указанным смещением, гарантирующим, что результат в тот же самый момент в подразумеваемый день. Этот метод возвращает объект с указанным ZoneOffset
и a LocalTime
скорректированный различием между двумя смещениями. Это приведет к старым и новым объектам, представляющим тот же самый момент подразумеваемый день. Это полезно для открытия местного времени в различном смещении. Например, если на сей раз представляет 10:30+02:00
и определенное смещение +03:00
, тогда этот метод возвратится 11:30+03:00
.
Изменить смещение, не корректируя использование местного времени withOffsetSameLocal(java.time.ZoneOffset)
.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
offset
- зональное смещение, чтобы изменить на, не нульOffsetTime
основанный на этом времени с требуемым смещением, не нулеpublic LocalTime toLocalTime()
LocalTime
часть этого разового датой. Это возвращает a LocalTime
с тем же самым часом, минутой, второй и наносекунда как это разовое датой.
public int getHour()
public int getMinute()
public int getSecond()
public int getNano()
public OffsetTime with(TemporalAdjuster adjuster)
Это возвращается OffsetTime
, основанный на этом, со скорректированным временем. Корректировка имеет место, используя указанный объект стратегии регулятора. Считайте документацию регулятора, чтобы понять, какая корректировка будет внесена.
Простой регулятор мог бы просто установить то из полей, таких как поле часа. Более сложный регулятор мог бы установить время в прошлый час дня.
Классы LocalTime
и ZoneOffset
реализация TemporalAdjuster
, таким образом этот метод может использоваться, чтобы изменить время или сместить:
result = offsetTime.with(time); result = offsetTime.with(offset);
Результат этого метода получается, вызывая TemporalAdjuster.adjustInto(Temporal)
метод на указанной передаче регулятора this
как параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульOffsetTime
основанный на this
с внесенной корректировкой, не нульDateTimeException
- если корректировка не может быть внесенаArithmeticException
- если числовое переполнение происходитpublic OffsetTime with(TemporalField field, long newValue)
Это возвращается OffsetTime
, основанный на этом, со значением для указанного поля изменился. Это может использоваться, чтобы изменить любое поддерживаемое поле, такое как час, минута или второй. Если не возможно установить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда корректировка реализуется здесь.
OFFSET_SECONDS
поле возвратит время с указанным смещением. Местное время неизменно. Если новое значение смещения вне допустимого диапазона тогда a DateTimeException
будет брошен.
Другой supported fields
будет вести себя согласно соответствующему методу на LocalTime.with(TemporalField, long)
LocalTime}. В этом случае смещение не является частью вычисления и будет неизменно.
Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.adjustInto(Temporal, long)
передача this
как параметр. В этом случае поле определяет, ли и как скорректировать момент.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеOffsetTime
основанный на this
с указанным полевым набором, не нулемDateTimeException
- если поле не может быть установленоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic OffsetTime withHour(int hour)
OffsetTime
с измененным значением часа-дневного. Смещение не влияет на вычисление и будет тем же самым в результате.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hour
- час-дневного, чтобы установить в результате, от 0 до 23OffsetTime
основанный на этом времени с требуемым часом, не нулеDateTimeException
- если значение часа недопустимоpublic OffsetTime withMinute(int minute)
OffsetTime
с мелким-часового измененным значением. Смещение не влияет на вычисление и будет тем же самым в результате.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minute
- минута-часового, чтобы установить в результате, от 0 до 59OffsetTime
основанный на этом времени с требуемой минутой, не нулеDateTimeException
- если мелкое значение недопустимоpublic OffsetTime withSecond(int second)
OffsetTime
со вторым-минутного измененным значением. Смещение не влияет на вычисление и будет тем же самым в результате.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
second
- второе-минутного, чтобы установить в результате, от 0 до 59OffsetTime
основанный на этом времени с требуемой секундой, не нулевойDateTimeException
- если второе значение недопустимоpublic OffsetTime withNano(int nanoOfSecond)
OffsetTime
с измененным значением nano-of-second. Смещение не влияет на вычисление и будет тем же самым в результате.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanoOfSecond
- nano-of-second, чтобы установить в результате, от 0 до 999 999 999OffsetTime
основанный на этом времени с требуемой наносекундой, не нулеDateTimeException
- если значение nanos недопустимоpublic OffsetTime truncatedTo(TemporalUnit unit)
OffsetTime
с усеченным временем. Усечение возвращает копию исходного времени с полями, меньшими чем указанный обнуленный модуль. Например, усечение с minutes
модуль обнулит второе-минутного и nano-of-second поле.
У модуля должна быть продолжительность, которая делится на продолжительность стандартного дня без остатка. Это включает все предоставленные единицы измерения времени на ChronoUnit
и DAYS
. Другие модули выдают исключение.
Смещение не влияет на вычисление и будет тем же самым в результате.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
unit
- модуль, чтобы усечь к, не нульOffsetTime
основанный на этом времени с усеченным временем, не нулевойDateTimeException
- если неспособный усекатьUnsupportedTemporalTypeException
- если модуль не поддерживаетсяpublic OffsetTime plus(TemporalAmount amountToAdd)
Это возвращается OffsetTime
, основанный на этом, с указанным добавленным количеством. Количество обычно Duration
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.addTo(Temporal)
. Реализация количества свободна реализовать дополнение всегда, это желает, однако это обычно перезванивает к plus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно добавлено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе Temporal
amountToAdd
- количество, чтобы добавить, не нульOffsetTime
основанный на этом времени со сделанным дополнением, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic OffsetTime plus(long amountToAdd, TemporalUnit unit)
Это возвращается OffsetTime
, основанный на этом, с количеством с точки зрения модуля добавил. Если не возможно добавить количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoUnit
тогда дополнение реализуется LocalTime.plus(long, TemporalUnit)
. Смещение не является частью вычисления и будет неизменно в результате.
Если поле не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.addTo(Temporal, long)
передача this
как параметр. В этом случае модуль определяет, ли и как выполнить дополнение.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе Temporal
amountToAdd
- количество модуля, чтобы добавить к результату, может быть отрицательнымunit
- модуль количества, чтобы добавить, не нульOffsetTime
основанный на этом времени с указанным количеством добавил, не нульDateTimeException
- если дополнение не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic OffsetTime plusHours(long hours)
OffsetTime
с установленным периодом в добавленных часах. Это добавляет конкретное количество часов к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hours
- часы, чтобы добавить, может быть отрицательнымOffsetTime
основанный на этом времени с часами добавил, не нульpublic OffsetTime plusMinutes(long minutes)
OffsetTime
с установленным периодом в добавленных минутах. Это добавляет конкретное количество минут к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minutes
- минуты, чтобы добавить, может быть отрицательнымOffsetTime
основанный на этом времени с минутами добавил, не нульpublic OffsetTime plusSeconds(long seconds)
OffsetTime
с установленным периодом в добавленных секундах. Это добавляет конкретное количество секунд к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
seconds
- секунды, чтобы добавить, может быть отрицательнымOffsetTime
основанный на этом времени с секундами добавил, не нульpublic OffsetTime plusNanos(long nanos)
OffsetTime
с установленным периодом в добавленных наносекундах. Это добавляет конкретное количество наносекунд к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanos
- nanos, чтобы добавить, может быть отрицательнымOffsetTime
основанный на этом времени с наносекундами добавил, не нульpublic OffsetTime minus(TemporalAmount amountToSubtract)
Это возвращается OffsetTime
, основанный на этом, с указанным вычтенным количеством. Количество обычно Duration
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.subtractFrom(Temporal)
. Реализация количества свободна реализовать вычитание всегда, это желает, однако это обычно перезванивает к minus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно вычтено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе Temporal
amountToSubtract
- количество, чтобы вычесть, не нульOffsetTime
основанный на этом времени со сделанным вычитанием, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic OffsetTime minus(long amountToSubtract, TemporalUnit unit)
Это возвращается OffsetTime
, основанный на этом, с количеством с точки зрения модуля вычитается. Если не возможно вычесть количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Этот метод эквивалентен plus(long, TemporalUnit)
с отрицаемым количеством. См., что метод для полного описания того, как дополнение, и таким образом вычитание, работают.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе Temporal
amountToSubtract
- количество модуля, чтобы вычесть из результата, может быть отрицательнымunit
- модуль количества, чтобы вычесть, не нульOffsetTime
основанный на этом времени с указанным вычтенным количеством, не нульDateTimeException
- если вычитание не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic OffsetTime minusHours(long hours)
OffsetTime
с установленным периодом в вычтенных часах. Это вычитает конкретное количество часов с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hours
- часы, чтобы вычесть, может быть отрицательнымOffsetTime
основанный на этом времени с вычтенными часами, не нульpublic OffsetTime minusMinutes(long minutes)
OffsetTime
с установленным периодом в вычтенных минутах. Это вычитает конкретное количество минут с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minutes
- минуты, чтобы вычесть, может быть отрицательнымOffsetTime
основанный на этом времени с вычтенными минутами, не нульpublic OffsetTime minusSeconds(long seconds)
OffsetTime
с установленным периодом в вычтенных секундах. Это вычитает конкретное количество секунд с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
seconds
- секунды, чтобы вычесть, может быть отрицательнымOffsetTime
основанный на этом времени с вычтенными секундами, не нульpublic OffsetTime minusNanos(long nanos)
OffsetTime
с установленным периодом в вычтенных наносекундах. Это вычитает конкретное количество наносекунд с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanos
- nanos, чтобы вычесть, может быть отрицательнымOffsetTime
основанный на этом времени с вычтенными наносекундами, не нульpublic <R> R query(TemporalQuery<R> query)
Это запрашивает на сей раз, используя указанный объект стратегии запроса. TemporalQuery
объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor)
метод на указанной передаче запроса this
как параметр.
query
в интерфейсе TemporalAccessor
R
- тип результатаquery
- запрос, чтобы вызвать, не нульDateTimeException
- если неспособный запрашивать (определенный запросом)ArithmeticException
- если числовое переполнение происходит (определенный запросом)public Temporal adjustInto(Temporal temporal)
Это возвращает временный объект того же самого заметного типа как ввод со смещением и время, измененное, чтобы быть тем же самым как этим.
Корректировка эквивалентна использованию Temporal.with(TemporalField, long)
дважды, передача ChronoField.NANO_OF_DAY
и ChronoField.OFFSET_SECONDS
как поля.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisOffsetTime.adjustInto(temporal); temporal = temporal.with(thisOffsetTime);
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic long periodUntil(Temporal endTime, TemporalUnit unit)
Это вычисляет количество времени между два OffsetTime
объекты с точки зрения сингла TemporalUnit
. Запуск и конечные точки this
и требуемое время. Результат будет отрицателен, если конец будет перед запуском. Например, период в часах между двумя разами может быть вычислен, используя startTime.periodUntil(endTime, HOURS)
.
Temporal
переданный к этому методу должен быть OffsetTime
. Если смещение отличается между этими двумя разами, то указанное время окончания нормализуется, чтобы иметь то же самое смещение как на сей раз.
Вычисление возвращает целое число, представляя число полных модулей между этими двумя разами. Например, период в часах между 11:30Z и 13:29Z только будет одним часом, поскольку это - одна минута за исключением двух часов.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal)
:
// these two lines are equivalent amount = start.periodUntil(end, MINUTES); amount = MINUTES.between(start, end);Выбор должен быть сделан основанный, которого делает код более читаемым.
Вычисление реализуется в этом методе для ChronoUnit
. Модули NANOS
, MICROS
, MILLIS
, SECONDS
, MINUTES
, HOURS
и HALF_DAYS
поддерживаются. Другой ChronoUnit
значения выдадут исключение.
Если модуль не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal)
передача this
как первый параметр и ввод, временный как второй параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе Temporal
endTime
- время окончания, которое должно быть OffsetTime
, не нульunit
- модуль, чтобы измерить количество в, не нульDateTimeException
- если количество не может быть вычисленоUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic String format(DateTimeFormatter formatter)
Это время передадут к средству форматирования, чтобы произвести строку.
formatter
- средство форматирования, чтобы использовать, не нульDateTimeException
- если ошибка происходит во время печатиpublic OffsetDateTime atDate(LocalDate date)
OffsetDateTime
. Это возвращается OffsetDateTime
сформированный с этого времени и указанной даты. Все возможные комбинации даты и время допустимы.
date
- дата, чтобы объединить с, не нульpublic int compareTo(OffsetTime other)
OffsetTime
к другому времени. Сравнение базируется сначала на UTC эквивалентный момент, затем на местном времени. Это является "непротиворечивым с, равняется", как определено Comparable
.
Например, следующее является порядком компаратора:
10:30+01:00
11:00+01:00
12:00+02:00
11:30+01:00
12:00+01:00
12:30+01:00
equals()
. Сравнить базовое местное время два TemporalAccessor
экземпляры, использовать ChronoField.NANO_OF_DAY
как компаратор.
compareTo
в интерфейсе Comparable<OffsetTime>
other
- другое время, чтобы сравнить с, не нульNullPointerException
- если other
нульpublic boolean isAfter(OffsetTime other)
OffsetTime
после того из требуемого времени, применяясь оба раза к общей дате. Этот метод отличается от сравнения в compareTo(java.time.OffsetTime)
в этом это только сравнивает момент времени. Это эквивалентно преобразованию оба раза в момент, используя ту же самую дату и сравнивая моменты.
other
- другое время, чтобы сравнить с, не нульpublic boolean isBefore(OffsetTime other)
OffsetTime
перед тем из требуемого времени, применяясь оба раза к общей дате. Этот метод отличается от сравнения в compareTo(java.time.OffsetTime)
в этом это только сравнивает момент времени. Это эквивалентно преобразованию оба раза в момент, используя ту же самую дату и сравнивая моменты.
other
- другое время, чтобы сравнить с, не нульpublic boolean isEqual(OffsetTime other)
OffsetTime
равно тому из требуемого времени, применяясь оба раза к общей дате. Этот метод отличается от сравнения в compareTo(java.time.OffsetTime)
и equals(java.lang.Object)
в этом это только сравнивает момент времени. Это эквивалентно преобразованию оба раза в момент, используя ту же самую дату и сравнивая моменты.
other
- другое время, чтобы сравнить с, не нульpublic boolean equals(Object obj)
Сравнение основано на местном времени и смещении. Чтобы сравниться в течение того же самого момента на временной шкале, использовать isEqual(OffsetTime)
.
Только объекты типа OffsetTime
сравниваются, другие типы возвращают false. Сравнить базовое местное время два TemporalAccessor
экземпляры, использовать ChronoField.NANO_OF_DAY
как компаратор.
equals
в class Object
obj
- объект проверить, обнулите, возвращает falseObject.hashCode()
, HashMap
public int hashCode()
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public String toString()
String
, такой как 10:15:30+01:00
. Вывод будет одним из следующих форматов ISO 8601:
HH:mmXXXXX
HH:mm:ssXXXXX
HH:mm:ss.SSSXXXXX
HH:mm:ss.SSSSSSXXXXX
HH:mm:ss.SSSSSSSSSXXXXX
Используемый формат будет самым коротким, который выводит полную стоимость времени, где опущенные части подразумеваются, чтобы быть нулем.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92