Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class LocalTime extends Object implements Temporal, TemporalAdjuster, Comparable<LocalTime>, Serializable
10:15:30
.
LocalTime
неизменный разовый датой объект, который представляет время, часто просматриваемое как "минута часа, вторая". Время представляется точности наносекунды. Например, значение "13:45.30.123456789" может быть сохранено в a LocalTime
.
Это не хранит или представляет дату или часовой пояс. Вместо этого это - описание местного времени как замечено на стенных часах. Это не может представить момент на временной шкале без дополнительной информации, такой как смещение или часовой пояс.
Календарная система ISO 8601 является современной гражданской календарной системой, используемой сегодня в большей части мира. Этот API предполагает, что все календарные системы используют то же самое представление, этот class, для времени суток.
Модификатор и Тип | Поле и Описание |
---|---|
static LocalTime |
МАКСИМАЛЬНЫЙ
Максимум поддерживается
LocalTime , '23:59:59.999999999'. |
static LocalTime |
ПОЛНОЧЬ
Время полуночи в начале дня, '00:00'.
|
static LocalTime |
МИН
Минимум поддерживается
LocalTime , '00:00'. |
static LocalTime |
ПОЛДЕНЬ
Время полудня в середине дня, '12:00'.
|
Модификатор и Тип | Метод и Описание |
---|---|
Временный |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь то же самое время как этот объект.
|
LocalDateTime |
atDate(LocalDate date)
Объединяется на сей раз с датой, чтобы создать a
LocalDateTime . |
OffsetTime |
atOffset(ZoneOffset offset)
Объединяется на сей раз со смещением, чтобы создать
OffsetTime . |
int |
compareTo(LocalTime other)
Сравнивает это
LocalTime к другому времени. |
boolean |
equals(Object obj)
Проверки, если это время равно другому времени.
|
Строка |
format(DateTimeFormatter formatter)
Форматы на сей раз, используя указанное средство форматирования.
|
static LocalTime |
from(TemporalAccessor temporal)
Получает экземпляр
LocalTime от временного объекта. |
int |
get(TemporalField field)
Получает значение указанного поля с этого времени как
int . |
int |
getHour()
Получает поле часа-дневного.
|
long |
getLong(TemporalField field)
Получает значение указанного поля с этого времени как a
long . |
int |
getMinute()
Получает мелкое-часового поле.
|
int |
getNano()
Получает nano-of-second поле.
|
int |
getSecond()
Получает второе-минутного поле.
|
int |
hashCode()
Хэш-код в течение этого времени.
|
boolean |
isAfter(LocalTime other)
Проверки, если это
LocalTime после требуемого времени. |
boolean |
isBefore(LocalTime other)
Проверки, если это
LocalTime перед требуемым временем. |
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
LocalTime |
minus(long amountToSubtract, TemporalUnit unit)
Возвращает копию этого времени с указанным вычтенным количеством.
|
LocalTime |
minus(TemporalAmount amountToSubtract)
Возвращает копию этого времени с указанным вычтенным количеством.
|
LocalTime |
minusHours(long hoursToSubtract)
Возвращает копию этого
LocalTime с установленным периодом в вычтенных часах. |
LocalTime |
minusMinutes(long minutesToSubtract)
Возвращает копию этого
LocalTime с установленным периодом в вычтенных минутах. |
LocalTime |
minusNanos(long nanosToSubtract)
Возвращает копию этого
LocalTime с установленным периодом в вычтенных наносекундах. |
LocalTime |
minusSeconds(long secondsToSubtract)
Возвращает копию этого
LocalTime с установленным периодом в вычтенных секундах. |
static LocalTime |
now()
Получает текущее время из системных часов в часовом поясе значения по умолчанию.
|
static LocalTime |
now(Clock clock)
Получает текущее время из указанных часов.
|
static LocalTime |
now(ZoneId zone)
Получает текущее время из системных часов в указанном часовом поясе.
|
static LocalTime |
of(int hour, int minute)
Получает экземпляр
LocalTime с часа и минуты. |
static LocalTime |
of(int hour, int minute, int second)
Получает экземпляр
LocalTime с часа, минуты и второй. |
static LocalTime |
of(int hour, int minute, int second, int nanoOfSecond)
Получает экземпляр
LocalTime с часа, минуты, второй и наносекунда. |
static LocalTime |
ofNanoOfDay(long nanoOfDay)
Получает экземпляр
LocalTime от значения nanos-of-day. |
static LocalTime |
ofSecondOfDay(long secondOfDay)
Получает экземпляр
LocalTime от второго-дневного значения. |
static LocalTime |
parse(CharSequence text)
Получает экземпляр
LocalTime от текстовой строки такой как 10:15 . |
static LocalTime |
parse(CharSequence text, DateTimeFormatter formatter)
Получает экземпляр
LocalTime от текстовой строки, используя определенное средство форматирования. |
long |
periodUntil(Temporal endTime, TemporalUnit unit)
Вычисляет количество времени до другого времени с точки зрения указанного модуля.
|
LocalTime |
plus(long amountToAdd, TemporalUnit unit)
Возвращает копию этого времени с указанным добавленным количеством.
|
LocalTime |
plus(TemporalAmount amountToAdd)
Возвращает копию этого времени с указанным добавленным количеством.
|
LocalTime |
plusHours(long hoursToAdd)
Возвращает копию этого
LocalTime с установленным периодом в добавленных часах. |
LocalTime |
plusMinutes(long minutesToAdd)
Возвращает копию этого
LocalTime с установленным периодом в добавленных минутах. |
LocalTime |
plusNanos(long nanosToAdd)
Возвращает копию этого
LocalTime с установленным периодом в добавленных наносекундах. |
LocalTime |
plusSeconds(long secondstoAdd)
Возвращает копию этого
LocalTime с установленным периодом в добавленных секундах. |
<R> R |
query(TemporalQuery<R> query)
Запросы на сей раз, используя указанный запрос.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
long |
toNanoOfDay()
Извлекает время как nanos дня, от
0 к 24 * 60 * 60 * 1,000,000,000 - 1 . |
int |
toSecondOfDay()
Извлекает время как секунды дня, от
0 к 24 * 60 * 60 - 1 . |
Строка |
toString()
Выводы на сей раз как a
String , такой как 10:15 . |
LocalTime |
truncatedTo(TemporalUnit unit)
Возвращает копию этого
LocalTime с усеченным временем. |
LocalTime |
with(TemporalAdjuster adjuster)
Возвращает скорректированную копию этого времени.
|
LocalTime |
with(TemporalField field, long newValue)
Возвращает копию этого времени с указанным полевым набором к новому значению.
|
LocalTime |
withHour(int hour)
Возвращает копию этого
LocalTime с измененным значением часа-дневного. |
LocalTime |
withMinute(int minute)
Возвращает копию этого
LocalTime с мелким-часового измененным значением. |
LocalTime |
withNano(int nanoOfSecond)
Возвращает копию этого
LocalTime с измененным значением nano-of-second. |
LocalTime |
withSecond(int second)
Возвращает копию этого
LocalTime со вторым-минутного измененным значением. |
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 LocalTime MIN
LocalTime
, '00:00'. Это - время полуночи в начале дня.public static final LocalTime MAX
LocalTime
, '23:59:59.999999999'. Это - время как раз перед полуночью в конце дня.public static final LocalTime MIDNIGHT
public static final LocalTime NOON
public static LocalTime now()
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить текущее время.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static LocalTime now(ZoneId zone)
Это запросит system clock
получить текущее время. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static LocalTime now(Clock clock)
Это запросит указанные часы, чтобы получить текущее время. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
clock
- часы, чтобы использовать, не нульpublic static LocalTime of(int hour, int minute)
LocalTime
с часа и минуты. Это возвращает a LocalTime
с указанным часом и минутой. Вторые поля и поля наносекунды будут обнулены.
hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic static LocalTime of(int hour, int minute, int second)
LocalTime
с часа, минуты и второй. Это возвращает a LocalTime
с указанным часом, минутой и второй. Поле наносекунды будет обнулено.
hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic static LocalTime of(int hour, int minute, int second, int nanoOfSecond)
LocalTime
с часа, минуты, второй и наносекунда. Это возвращает a LocalTime
с указанным часом, минутой, второй и наносекунда.
hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59nanoOfSecond
- nano-of-second, чтобы представить, от 0 до 999 999 999DateTimeException
- если значение какого-либо поля испытывает недостаток диапазонаpublic static LocalTime ofSecondOfDay(long secondOfDay)
LocalTime
от второго-дневного значения. Это возвращает a LocalTime
с указанным вторым-дневного. Поле наносекунды будет обнулено.
secondOfDay
- второе-дневного, от 0
к 24 * 60 * 60 - 1
DateTimeException
- если второе-дневного значение недопустимоpublic static LocalTime ofNanoOfDay(long nanoOfDay)
LocalTime
от значения nanos-of-day. Это возвращает a LocalTime
с указанной наносекундой-дневного.
nanoOfDay
- nano дня, от 0
к 24 * 60 * 60 * 1,000,000,000 - 1
DateTimeException
- если nanos дневного значения недопустимpublic static LocalTime from(TemporalAccessor temporal)
LocalTime
от временного объекта. Это получает местное время, основанное на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр LocalTime
.
Преобразование использует TemporalQuery.localTime()
запрос, который полагается на извлечение NANO_OF_DAY
поле.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в запросах через ссылку метода, LocalTime::from
.
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a LocalTime
public static LocalTime parse(CharSequence text)
LocalTime
от текстовой строки такой как 10:15
. Строка должна представить допустимое время и анализируется, используя DateTimeFormatter.ISO_LOCAL_TIME
.
text
- текст, чтобы проанализировать, такие как "10:15:30", не нульDateTimeParseException
- если текст не может быть проанализированpublic static LocalTime parse(CharSequence text, DateTimeFormatter formatter)
LocalTime
от текстовой строки, используя определенное средство форматирования. Текст анализируется, используя средство форматирования, возвращая время.
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
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 int getHour()
public int getMinute()
public int getSecond()
public int getNano()
public LocalTime with(TemporalAdjuster adjuster)
Это возвращает a LocalTime
, основанный на этом, со скорректированным временем. Корректировка имеет место, используя указанный объект стратегии регулятора. Считайте документацию регулятора, чтобы понять, какая корректировка будет внесена.
Простой регулятор мог бы просто установить то из полей, таких как поле часа. Более сложный регулятор мог бы установить время в прошлый час дня.
Результат этого метода получается, вызывая TemporalAdjuster.adjustInto(Temporal)
метод на указанной передаче регулятора this
как параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульLocalTime
основанный на this
с внесенной корректировкой, не нульDateTimeException
- если корректировка не может быть внесенаArithmeticException
- если числовое переполнение происходитpublic LocalTime with(TemporalField field, long newValue)
Это возвращает a LocalTime
, основанный на этом, со значением для указанного поля изменился. Это может использоваться, чтобы изменить любое поддерживаемое поле, такое как час, минута или второй. Если не возможно установить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoField
тогда корректировка реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
NANO_OF_SECOND
- Возвраты a LocalTime
с указанным nano-of-second. Час, минута и второй будут неизменны. NANO_OF_DAY
- Возвраты a LocalTime
с указанным nano-of-day. Это полностью заменяет время и эквивалентно ofNanoOfDay(long)
. MICRO_OF_SECOND
- Возвраты a LocalTime
с nano-of-second, замененным указанным, "микро из вторых", умноженных на 1 000. Час, минута и второй будут неизменны. MICRO_OF_DAY
- Возвраты a LocalTime
с указанным, "микро изо дня". Это полностью заменяет время и эквивалентно использованию ofNanoOfDay(long)
с "микро изо дня" умножился на 1 000. MILLI_OF_SECOND
- Возвраты a LocalTime
с nano-of-second, замененным указанным milli-of-second, умножился на 1 000 000. Час, минута и второй будут неизменны. MILLI_OF_DAY
- Возвраты a LocalTime
с указанным milli-of-day. Это полностью заменяет время и эквивалентно использованию ofNanoOfDay(long)
с milli-of-day, умноженным на 1 000 000. SECOND_OF_MINUTE
- Возвраты a LocalTime
с указанным вторым-минутного. Час, минута и nano-of-second будут неизменны. SECOND_OF_DAY
- Возвраты a LocalTime
с указанным вторым-дневного. nano-of-second будет неизменен. MINUTE_OF_HOUR
- Возвраты a LocalTime
с указанной минутой-часового. Час, второй-минутного и nano-of-second, будет неизменен. MINUTE_OF_DAY
- Возвраты a LocalTime
с указанной минутой-дневного. Второе-минутного и nano-of-second будут неизменны. HOUR_OF_AMPM
- Возвраты a LocalTime
с указанным "часом пополудни"./PM, минута-часового, вторая-минутного и nano-of-second, будет неизменен. CLOCK_HOUR_OF_AMPM
- Возвраты a LocalTime
с указанным "часом часов пополудни"./PM, минута-часового, вторая-минутного и nano-of-second, будет неизменен. HOUR_OF_DAY
- Возвраты a LocalTime
с указанным часом-дневного. Минута-часового, вторая-минутного и nano-of-second, будет неизменна. CLOCK_HOUR_OF_DAY
- Возвраты a LocalTime
с указанным "часом часов дня". Минута-часового, вторая-минутного и nano-of-second, будет неизменна. AMPM_OF_DAY
- Возвраты a LocalTime
с указанным/PM. "Час - пополудни", минута-часового, вторая-минутного и nano-of-second, будет неизменна. Во всех случаях, если новое значение вне допустимого диапазона значений для поля тогда a DateTimeException
будет брошен.
Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.adjustInto(Temporal, long)
передача this
как параметр. В этом случае поле определяет, ли и как скорректировать момент.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеLocalTime
основанный на this
с указанным полевым набором, не нулемDateTimeException
- если поле не может быть установленоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalTime withHour(int hour)
LocalTime
с измененным значением часа-дневного. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hour
- час-дневного, чтобы установить в результате, от 0 до 23LocalTime
основанный на этом времени с требуемым часом, не нулеDateTimeException
- если значение часа недопустимоpublic LocalTime withMinute(int minute)
LocalTime
с мелким-часового измененным значением. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minute
- минута-часового, чтобы установить в результате, от 0 до 59LocalTime
основанный на этом времени с требуемой минутой, не нулеDateTimeException
- если мелкое значение недопустимоpublic LocalTime withSecond(int second)
LocalTime
со вторым-минутного измененным значением. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
second
- второе-минутного, чтобы установить в результате, от 0 до 59LocalTime
основанный на этом времени с требуемой секундой, не нулевойDateTimeException
- если второе значение недопустимоpublic LocalTime withNano(int nanoOfSecond)
LocalTime
с измененным значением nano-of-second. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanoOfSecond
- nano-of-second, чтобы установить в результате, от 0 до 999 999 999LocalTime
основанный на этом времени с требуемой наносекундой, не нулеDateTimeException
- если значение nanos недопустимоpublic LocalTime truncatedTo(TemporalUnit unit)
LocalTime
с усеченным временем. Усечение времени возвращает копию исходного времени с полями, меньшими чем указанный обнуленный модуль. Например, усечение с minutes
модуль обнулит второе-минутного и nano-of-second поле.
У модуля должна быть продолжительность, которая делится на продолжительность стандартного дня без остатка. Это включает все предоставленные единицы измерения времени на ChronoUnit
и DAYS
. Другие модули выдают исключение.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
unit
- модуль, чтобы усечь к, не нульLocalTime
основанный на этом времени с усеченным временем, не нулевойDateTimeException
- если неспособный усекатьUnsupportedTemporalTypeException
- если модуль не поддерживаетсяpublic LocalTime plus(TemporalAmount amountToAdd)
Это возвращает a LocalTime
, основанный на этом, с указанным добавленным количеством. Количество обычно Duration
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.addTo(Temporal)
. Реализация количества свободна реализовать дополнение всегда, это желает, однако это обычно перезванивает к plus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно добавлено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе Temporal
amountToAdd
- количество, чтобы добавить, не нульLocalTime
основанный на этом времени со сделанным дополнением, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic LocalTime plus(long amountToAdd, TemporalUnit unit)
Это возвращает a LocalTime
, основанный на этом, с количеством с точки зрения модуля добавил. Если не возможно добавить количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoUnit
тогда дополнение реализуется здесь. Поддерживаемые поля ведут себя следующим образом:
NANOS
- Возвраты a LocalTime
с конкретным количеством добавленных наносекунд. Это эквивалентно plusNanos(long)
. MICROS
- Возвраты a LocalTime
с конкретным количеством добавленных микросекунд. Это эквивалентно plusNanos(long)
с количеством, умноженным на 1 000. MILLIS
- Возвраты a LocalTime
с конкретным количеством добавленных миллисекунд. Это эквивалентно plusNanos(long)
с количеством, умноженным на 1 000 000. SECONDS
- Возвраты a LocalTime
с конкретным количеством добавленных секунд. Это эквивалентно plusSeconds(long)
. MINUTES
- Возвраты a LocalTime
с конкретным количеством добавленных минут. Это эквивалентно plusMinutes(long)
. HOURS
- Возвраты a LocalTime
с конкретным количеством добавленных часов. Это эквивалентно plusHours(long)
. HALF_DAYS
- Возвраты a LocalTime
с конкретным количеством добавленных неполных рабочих дней. Это эквивалентно plusHours(long)
с количеством, умноженным на 12. Все другой ChronoUnit
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.addTo(Temporal, long)
передача this
как параметр. В этом случае модуль определяет, ли и как выполнить дополнение.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе Temporal
amountToAdd
- количество модуля, чтобы добавить к результату, может быть отрицательнымunit
- модуль количества, чтобы добавить, не нульLocalTime
основанный на этом времени с указанным количеством добавил, не нульDateTimeException
- если дополнение не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalTime plusHours(long hoursToAdd)
LocalTime
с установленным периодом в добавленных часах. Это добавляет конкретное количество часов к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hoursToAdd
- часы, чтобы добавить, может быть отрицательнымLocalTime
основанный на этом времени с часами добавил, не нульpublic LocalTime plusMinutes(long minutesToAdd)
LocalTime
с установленным периодом в добавленных минутах. Это добавляет конкретное количество минут к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minutesToAdd
- минуты, чтобы добавить, может быть отрицательнымLocalTime
основанный на этом времени с минутами добавил, не нульpublic LocalTime plusSeconds(long secondstoAdd)
LocalTime
с установленным периодом в добавленных секундах. Это добавляет конкретное количество секунд к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
secondstoAdd
- секунды, чтобы добавить, может быть отрицательнымLocalTime
основанный на этом времени с секундами добавил, не нульpublic LocalTime plusNanos(long nanosToAdd)
LocalTime
с установленным периодом в добавленных наносекундах. Это добавляет конкретное количество наносекунд к этому времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanosToAdd
- nanos, чтобы добавить, может быть отрицательнымLocalTime
основанный на этом времени с наносекундами добавил, не нульpublic LocalTime minus(TemporalAmount amountToSubtract)
Это возвращает a LocalTime
, основанный на этом, с указанным вычтенным количеством. Количество обычно Duration
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.subtractFrom(Temporal)
. Реализация количества свободна реализовать вычитание всегда, это желает, однако это обычно перезванивает к minus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно вычтено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе Temporal
amountToSubtract
- количество, чтобы вычесть, не нульLocalTime
основанный на этом времени со сделанным вычитанием, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic LocalTime minus(long amountToSubtract, TemporalUnit unit)
Это возвращает a LocalTime
, основанный на этом, с количеством с точки зрения модуля вычитается. Если не возможно вычесть количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Этот метод эквивалентен plus(long, TemporalUnit)
с отрицаемым количеством. См., что метод для полного описания того, как дополнение, и таким образом вычитание, работают.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе Temporal
amountToSubtract
- количество модуля, чтобы вычесть из результата, может быть отрицательнымunit
- модуль количества, чтобы вычесть, не нульLocalTime
основанный на этом времени с указанным вычтенным количеством, не нульDateTimeException
- если вычитание не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalTime minusHours(long hoursToSubtract)
LocalTime
с установленным периодом в вычтенных часах. Это вычитает конкретное количество часов с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hoursToSubtract
- часы, чтобы вычесть, может быть отрицательнымLocalTime
основанный на этом времени с вычтенными часами, не нульpublic LocalTime minusMinutes(long minutesToSubtract)
LocalTime
с установленным периодом в вычтенных минутах. Это вычитает конкретное количество минут с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minutesToSubtract
- минуты, чтобы вычесть, может быть отрицательнымLocalTime
основанный на этом времени с вычтенными минутами, не нульpublic LocalTime minusSeconds(long secondsToSubtract)
LocalTime
с установленным периодом в вычтенных секундах. Это вычитает конкретное количество секунд с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
secondsToSubtract
- секунды, чтобы вычесть, может быть отрицательнымLocalTime
основанный на этом времени с вычтенными секундами, не нульpublic LocalTime minusNanos(long nanosToSubtract)
LocalTime
с установленным периодом в вычтенных наносекундах. Это вычитает конкретное количество наносекунд с этого времени, возвращая новое время. Вычисление переносит полночь.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanosToSubtract
- nanos, чтобы вычесть, может быть отрицательнымLocalTime
основанный на этом времени с вычтенными наносекундами, не нуль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
как поле.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisLocalTime.adjustInto(temporal); temporal = temporal.with(thisLocalTime);
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic long periodUntil(Temporal endTime, TemporalUnit unit)
Это вычисляет количество времени между два LocalTime
объекты с точки зрения сингла TemporalUnit
. Запуск и конечные точки this
и требуемое время. Результат будет отрицателен, если конец будет перед запуском. Temporal
переданный к этому методу должен быть a LocalTime
. Например, количество в часах между двумя разами может быть вычислено, используя startTime.periodUntil(endTime, HOURS)
.
Вычисление возвращает целое число, представляя число полных модулей между этими двумя разами. Например, количество в часах между 11:30 и 13:29 только будет одним часом, поскольку это - одна минута за исключением двух часов.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать 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
- время окончания, которое должно быть a LocalTime
, не нульunit
- модуль, чтобы измерить количество в, не нульDateTimeException
- если количество не может быть вычисленоUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic String format(DateTimeFormatter formatter)
Это время передадут к средству форматирования, чтобы произвести строку.
formatter
- средство форматирования, чтобы использовать, не нульDateTimeException
- если ошибка происходит во время печатиpublic LocalDateTime atDate(LocalDate date)
LocalDateTime
. Это возвращает a LocalDateTime
сформированный с этого времени в указанной дате. Все возможные комбинации даты и время допустимы.
date
- дата, чтобы объединить с, не нульpublic OffsetTime atOffset(ZoneOffset offset)
OffsetTime
. Это возвращается OffsetTime
сформированный с этого времени при указанном смещении. Все возможные комбинации времени и смещения допустимы.
offset
- смещение, чтобы объединить с, не нульpublic int toSecondOfDay()
0
к 24 * 60 * 60 - 1
.public long toNanoOfDay()
0
к 24 * 60 * 60 * 1,000,000,000 - 1
.public int compareTo(LocalTime other)
LocalTime
к другому времени. Сравнение основано на позиции временной шкалы местного времени в течение дня. Это является "непротиворечивым с, равняется", как определено Comparable
.
compareTo
в интерфейсе Comparable<LocalTime>
other
- другое время, чтобы сравнить с, не нульNullPointerException
- если other
нульpublic boolean isAfter(LocalTime other)
LocalTime
после требуемого времени. Сравнение основано на позиции временной шкалы времени в течение дня.
other
- другое время, чтобы сравнить с, не нульNullPointerException
- если other
нульpublic boolean isBefore(LocalTime other)
LocalTime
перед требуемым временем. Сравнение основано на позиции временной шкалы времени в течение дня.
other
- другое время, чтобы сравнить с, не нульNullPointerException
- если other
нульpublic boolean equals(Object obj)
Сравнение основано на позиции временной шкалы времени в течение дня.
Только объекты типа LocalTime
сравниваются, другие типы возвращают 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
. Вывод будет одним из следующих форматов ISO 8601:
HH:mm
HH:mm:ss
HH:mm:ss.SSS
HH:mm:ss.SSSSSS
HH:mm:ss.SSSSSSSSS
Используемый формат будет самым коротким, который выводит полную стоимость времени, где опущенные части подразумеваются, чтобы быть нулем.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92