Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class LocalDateTime extends Object implements Temporal, TemporalAdjuster, ChronoLocalDateTime<LocalDate>, Serializable
2007-12-03T10:15:30
.
LocalDateTime
неизменный разовый датой объект, который представляет разовое датой, часто просматриваемое как "дневная минута часа месяца года, вторая". К другой дате и полям времени, таким как день-летнего, день-недельного и неделя-летнего, можно также получить доступ. Время представляется точности наносекунды. Например, значение "2-ого октября 2007 в 13:45.30.123456789" может быть сохранено в a LocalDateTime
.
Этот class не хранит или представляет часовой пояс. Вместо этого это - описание даты, столь же используемой на дни рождения, объединенные с местным временем как замечено на стенных часах. Это не может представить момент на временной шкале без дополнительной информации, такой как смещение или часовой пояс.
Календарная система ISO 8601 является современной гражданской календарной системой, используемой сегодня в большей части мира. Это эквивалентно преждевременной системе Григорианского календаря, в которой сегодняшние правила в течение многих високосных годов применяются навсегда. Для большинства приложений, записанных сегодня, правила ISO 8601 являются полностью подходящими. Однако, любое приложение, которое использует исторические даты, и требует, чтобы они были точны, сочтет подход ISO 8601 неподходящим.
Модификатор и Тип | Поле и Описание |
---|---|
static LocalDateTime |
МАКСИМАЛЬНЫЙ
Максимум поддерживается
LocalDateTime , '+999999999-12-31T23:59:59.999999999'. |
static LocalDateTime |
МИН
Минимум поддерживается
LocalDateTime , '-999999999-01-01T00:00:00'. |
Модификатор и Тип | Метод и Описание |
---|---|
Временный |
adjustInto(Temporal temporal)
Корректирует указанный временный объект иметь ту же самую дату и время как этот объект.
|
OffsetDateTime |
atOffset(ZoneOffset offset)
Комбинирует это разовое датой со смещением, чтобы создать
OffsetDateTime . |
ZonedDateTime |
atZone(ZoneId zone)
Комбинирует это разовое датой с часовым поясом, чтобы создать a
ZonedDateTime . |
int |
compareTo(ChronoLocalDateTime<?> other)
Сравнивает это разовое датой с другим разовым датой.
|
boolean |
equals(Object obj)
Проверки, если это разовое датой равно другому разовому датой.
|
Строка |
format(DateTimeFormatter formatter)
Форматы это разовое датой использование указанного средства форматирования.
|
static LocalDateTime |
from(TemporalAccessor temporal)
Получает экземпляр
LocalDateTime от временного объекта. |
int |
get(TemporalField field)
Получает значение указанного поля от этого разового датой как
int . |
int |
getDayOfMonth()
Получает дневное-месячного поле.
|
DayOfWeek |
getDayOfWeek()
Получает дневное-недельного поле, которое является перечислением
DayOfWeek . |
int |
getDayOfYear()
Получает дневное-летнего поле.
|
int |
getHour()
Получает поле часа-дневного.
|
long |
getLong(TemporalField field)
Получает значение указанного поля от этого разового датой как a
long . |
int |
getMinute()
Получает мелкое-часового поле.
|
Месяц |
getMonth()
Получает поле месяца-летнего, используя
Month перечисление. |
int |
getMonthValue()
Получает поле месяца-летнего от 1 до 12.
|
int |
getNano()
Получает nano-of-second поле.
|
int |
getSecond()
Получает второе-минутного поле.
|
int |
getYear()
Получает поле года.
|
int |
hashCode()
Хэш-код для этого разового датой.
|
boolean |
isAfter(ChronoLocalDateTime<?> other)
Проверки, если это разовое датой после указанного разового датой.
|
boolean |
isBefore(ChronoLocalDateTime<?> other)
Проверки, если это разовое датой перед указанным разовым датой.
|
boolean |
isEqual(ChronoLocalDateTime<?> other)
Проверки, если это разовое датой равно указанному разовому датой.
|
boolean |
isSupported(TemporalField field)
Проверки, если указанное поле поддерживается.
|
LocalDateTime |
minus(long amountToSubtract, TemporalUnit unit)
Возвращает копию этого разового датой с указанным вычтенным количеством.
|
LocalDateTime |
minus(TemporalAmount amountToSubtract)
Возвращает копию этого разового датой с указанным вычтенным количеством.
|
LocalDateTime |
minusDays(long days)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных днях. |
LocalDateTime |
minusHours(long hours)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных часах. |
LocalDateTime |
minusMinutes(long minutes)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных минутах. |
LocalDateTime |
minusMonths(long months)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных месяцах. |
LocalDateTime |
minusNanos(long nanos)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных наносекундах. |
LocalDateTime |
minusSeconds(long seconds)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных секундах. |
LocalDateTime |
minusWeeks(long weeks)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных неделях. |
LocalDateTime |
minusYears(long years)
Возвращает копию этого
LocalDateTime с установленным периодом в вычтенных годах. |
static LocalDateTime |
now()
Получает ток, разовый датой из системных часов в часовом поясе значения по умолчанию.
|
static LocalDateTime |
now(Clock clock)
Получает ток, разовый датой из указанных часов.
|
static LocalDateTime |
now(ZoneId zone)
Получает ток, разовый датой из системных часов в указанном часовом поясе.
|
static LocalDateTime |
of(int year, int month, int dayOfMonth, int hour, int minute)
Получает экземпляр
LocalDateTime с года, месяца, дня, часа и минуты, обнуляя второе и наносекунда. |
static LocalDateTime |
of(int year, int month, int dayOfMonth, int hour, int minute, int second)
Получает экземпляр
LocalDateTime с года, месяца, дня, часа, минуты и во-вторых, обнуляя наносекунду. |
static LocalDateTime |
of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
Получает экземпляр
LocalDateTime с года, месяца, дня, часа, минуты, второй и наносекунда. |
static LocalDateTime |
of(int year, Month month, int dayOfMonth, int hour, int minute)
Получает экземпляр
LocalDateTime с года, месяца, дня, часа и минуты, обнуляя второе и наносекунда. |
static LocalDateTime |
of(int year, Month month, int dayOfMonth, int hour, int minute, int second)
Получает экземпляр
LocalDateTime с года, месяца, дня, часа, минуты и во-вторых, обнуляя наносекунду. |
static LocalDateTime |
of(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
Получает экземпляр
LocalDateTime с года, месяца, дня, часа, минуты, второй и наносекунда. |
static LocalDateTime |
of(LocalDate date, LocalTime time)
Получает экземпляр
LocalDateTime с даты и время. |
static LocalDateTime |
ofEpochSecond(long epochSecond, int nanoOfSecond, ZoneOffset offset)
Получает экземпляр
LocalDateTime использование секунд от эпохи 1970-01-01T00:00:00Z. |
static LocalDateTime |
ofInstant(Instant instant, ZoneId zone)
Получает экземпляр
LocalDateTime от Instant и зональный ID. |
static LocalDateTime |
parse(CharSequence text)
Получает экземпляр
LocalDateTime от текстовой строки такой как 2007-12-03T10:15:30 . |
static LocalDateTime |
parse(CharSequence text, DateTimeFormatter formatter)
Получает экземпляр
LocalDateTime от текстовой строки, используя определенное средство форматирования. |
long |
periodUntil(Temporal endDateTime, TemporalUnit unit)
Вычисляет количество времени до другого разового датой с точки зрения указанного модуля.
|
LocalDateTime |
plus(long amountToAdd, TemporalUnit unit)
Возвращает копию этого разового датой с указанным добавленным количеством.
|
LocalDateTime |
plus(TemporalAmount amountToAdd)
Возвращает копию этого разового датой с указанным добавленным количеством.
|
LocalDateTime |
plusDays(long days)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных днях. |
LocalDateTime |
plusHours(long hours)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных часах. |
LocalDateTime |
plusMinutes(long minutes)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных минутах. |
LocalDateTime |
plusMonths(long months)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных месяцах. |
LocalDateTime |
plusNanos(long nanos)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных наносекундах. |
LocalDateTime |
plusSeconds(long seconds)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных секундах. |
LocalDateTime |
plusWeeks(long weeks)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных неделях. |
LocalDateTime |
plusYears(long years)
Возвращает копию этого
LocalDateTime с установленным периодом в добавленных годах. |
<R> R |
query(TemporalQuery<R> query)
Запросы это разовое датой использование указанного запроса.
|
ValueRange |
range(TemporalField field)
Получает диапазон допустимых значений для указанного поля.
|
LocalDate |
toLocalDate()
Добирается
LocalDate часть этого разового датой. |
LocalTime |
toLocalTime()
Добирается
LocalTime часть этого разового датой. |
Строка |
toString()
Выводит это разовое датой как a
String , такой как 2007-12-03T10:15:30 . |
LocalDateTime |
truncatedTo(TemporalUnit unit)
Возвращает копию этого
LocalDateTime с усеченным временем. |
LocalDateTime |
with(TemporalAdjuster adjuster)
Возвращает скорректированную копию этого разового датой.
|
LocalDateTime |
with(TemporalField field, long newValue)
Возвращает копию этого разового датой с указанным полевым набором к новому значению.
|
LocalDateTime |
withDayOfMonth(int dayOfMonth)
Возвращает копию этого
LocalDateTime с измененным днем-месячного. |
LocalDateTime |
withDayOfYear(int dayOfYear)
Возвращает копию этого
LocalDateTime с измененным днем-летнего. |
LocalDateTime |
withHour(int hour)
Возвращает копию этого
LocalDateTime с измененным значением часа-дневного. |
LocalDateTime |
withMinute(int minute)
Возвращает копию этого
LocalDateTime с мелким-часового измененным значением. |
LocalDateTime |
withMonth(int month)
Возвращает копию этого
LocalDateTime с измененным месяцем-летнего. |
LocalDateTime |
withNano(int nanoOfSecond)
Возвращает копию этого
LocalDateTime с измененным значением nano-of-second. |
LocalDateTime |
withSecond(int second)
Возвращает копию этого
LocalDateTime со вторым-минутного измененным значением. |
LocalDateTime |
withYear(int year)
Возвращает копию этого
LocalDateTime с измененным годом. |
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
timeLineOrder, toEpochSecond, toInstant
dayOfWeekInMonth, firstDayOfMonth, firstDayOfNextMonth, firstDayOfNextYear, firstDayOfYear, firstInMonth, lastDayOfMonth, lastDayOfYear, lastInMonth, next, nextOrSame, ofDateAdjuster, previous, previousOrSame
public static final LocalDateTime MIN
LocalDateTime
, '-999999999-01-01T00:00:00'. Это - локальная переменная, разовая датой из полуночи в начале минимальной даты. Это объединяется LocalDate.MIN
и LocalTime.MIN
. Это могло использоваться приложением в качестве "далекого прошлого", разового датой.public static final LocalDateTime MAX
LocalDateTime
, '+999999999-12-31T23:59:59.999999999'. Это - локальная переменная, разовая датой как раз перед полуночью в конце максимальной даты. Это объединяется LocalDate.MAX
и LocalTime.MAX
. Это могло использоваться приложением в качестве "далекого будущего", разового датой.public static LocalDateTime now()
Это запросит system clock
в часовом поясе значения по умолчанию, чтобы получить разовый датой ток.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
public static LocalDateTime now(ZoneId zone)
Это запросит system clock
получить разовый датой ток. Определение часового пояса избегает зависимости от часового пояса значения по умолчанию.
Используя этот метод предотвратит возможность использовать альтернативные часы для того, чтобы протестировать, потому что часы трудно кодируются.
zone
- зональный ID, чтобы использовать, не нульpublic static LocalDateTime now(Clock clock)
Это запросит указанные часы, чтобы получить разовый датой ток. Используя этот метод позволяет использование альтернативных часов для того, чтобы протестировать. Альтернативные часы могут быть представлены, используя dependency injection
.
clock
- часы, чтобы использовать, не нульpublic static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute)
LocalDateTime
с года, месяца, дня, часа и минуты, обнуляя второе и наносекунда. Это возвращает a LocalDateTime
с указанным годом, месяцем, днем-месячного, часом и минутой. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано. Вторые поля и поля наносекунды будут обнулены.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, не нульdayOfMonth
- день-месячного, чтобы представить, от 1 до 31hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second)
LocalDateTime
с года, месяца, дня, часа, минуты и во-вторых, обнуляя наносекунду. Это возвращает a LocalDateTime
с указанным годом, месяцем, днем-месячного, часом, минутой и второй. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано. Поле наносекунды будет обнулено.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, не нульdayOfMonth
- день-месячного, чтобы представить, от 1 до 31hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDateTime of(int year, Month month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
LocalDateTime
с года, месяца, дня, часа, минуты, второй и наносекунда. Это возвращает a LocalDateTime
с указанным годом, месяцем, днем-месячного, часом, минутой, второй и наносекунда. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, не нульdayOfMonth
- день-месячного, чтобы представить, от 1 до 31hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59nanoOfSecond
- nano-of-second, чтобы представить, от 0 до 999 999 999DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute)
LocalDateTime
с года, месяца, дня, часа и минуты, обнуляя второе и наносекунда. Это возвращает a LocalDateTime
с указанным годом, месяцем, днем-месячного, часом и минутой. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано. Вторые поля и поля наносекунды будут обнулены.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)dayOfMonth
- день-месячного, чтобы представить, от 1 до 31hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second)
LocalDateTime
с года, месяца, дня, часа, минуты и во-вторых, обнуляя наносекунду. Это возвращает a LocalDateTime
с указанным годом, месяцем, днем-месячного, часом, минутой и второй. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано. Поле наносекунды будет обнулено.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)dayOfMonth
- день-месячного, чтобы представить, от 1 до 31hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDateTime of(int year, int month, int dayOfMonth, int hour, int minute, int second, int nanoOfSecond)
LocalDateTime
с года, месяца, дня, часа, минуты, второй и наносекунда. Это возвращает a LocalDateTime
с указанным годом, месяцем, днем-месячного, часом, минутой, второй и наносекунда. День должен быть допустимым в течение года и месяца, иначе исключение будет выдано.
year
- год, чтобы представить, от MIN_YEAR до MAX_YEARmonth
- месяц-летнего, чтобы представить, от 1 (январь) к 12 (декабрь)dayOfMonth
- день-месячного, чтобы представить, от 1 до 31hour
- час-дневного, чтобы представить, от 0 до 23minute
- минута-часового, чтобы представить, от 0 до 59second
- второе-минутного, чтобы представить, от 0 до 59nanoOfSecond
- nano-of-second, чтобы представить, от 0 до 999 999 999DateTimeException
- если значение какого-либо поля испытывает недостаток диапазона, или если день-месячного недопустим для летнего месяцемpublic static LocalDateTime of(LocalDate date, LocalTime time)
LocalDateTime
с даты и время.date
- локальная дата, не нульtime
- местное время, не нульpublic static LocalDateTime ofInstant(Instant instant, ZoneId zone)
LocalDateTime
от Instant
и зональный ID. Это создает локальную переменную, разовую датой основанный на указанном моменте. Во-первых, смещение от UTC/Гринвича получается, используя зональный ID и момент, который прост, поскольку есть только одно допустимое смещение в течение каждого момента. Затем, момент и смещение используются, чтобы вычислить разовую датой локальную переменную.
instant
- момент, чтобы создать разовое датой из, не нульzone
- часовой пояс, который может быть смещением, не нулемDateTimeException
- если результат превышает поддерживаемый диапазонpublic static LocalDateTime ofEpochSecond(long epochSecond, int nanoOfSecond, ZoneOffset offset)
LocalDateTime
использование секунд от эпохи 1970-01-01T00:00:00Z. Это позволяет epoch-second
поле, которое будет преобразовано в разовую датой локальную переменную. Это прежде всего предназначается для низкоуровневых преобразований, а не общего использования приложения.
epochSecond
- число секунд от эпохи 1970-01-01T00:00:00ZnanoOfSecond
- наносекунда в пределах второго, от 0 до 999 999 999offset
- зональное смещение, не нульDateTimeException
- если результат превышает поддерживаемый диапазон, или если nano-of-second недопустимpublic static LocalDateTime from(TemporalAccessor temporal)
LocalDateTime
от временного объекта. Это получает время смещения, основанное на указанном временном. A TemporalAccessor
представляет произвольный набор даты и информации времени, из которой эта фабрика преобразовывает в экземпляр LocalDateTime
.
Преобразование извлекает и объединяется LocalDate
и LocalTime
от временного объекта. Реализациям разрешают выполнить оптимизацию, такую как доступ к тем полям, которые эквивалентны соответствующим объектам.
Этот метод соответствует подпись функционального интерфейса TemporalQuery
разрешение этого использоваться в качестве запроса через ссылку метода, LocalDateTime::from
.
from
в интерфейсе ChronoLocalDateTime<LocalDate>
temporal
- временный объект преобразовать, не нульDateTimeException
- если неспособный преобразовать в a LocalDateTime
Chronology.localDateTime(TemporalAccessor)
public static LocalDateTime parse(CharSequence text)
LocalDateTime
от текстовой строки такой как 2007-12-03T10:15:30
. Строка должна представить допустимое разовое датой и анализируется, используя DateTimeFormatter.ISO_LOCAL_DATE_TIME
.
text
- текст, чтобы проанализировать, такие как "2007-12-03T10:15:30", не нульDateTimeParseException
- если текст не может быть проанализированpublic static LocalDateTime parse(CharSequence text, DateTimeFormatter formatter)
LocalDateTime
от текстовой строки, используя определенное средство форматирования. Текст анализируется, используя средство форматирования, возвращая разовое датой.
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
DAY_OF_WEEK
ALIGNED_DAY_OF_WEEK_IN_MONTH
ALIGNED_DAY_OF_WEEK_IN_YEAR
DAY_OF_MONTH
DAY_OF_YEAR
EPOCH_DAY
ALIGNED_WEEK_OF_MONTH
ALIGNED_WEEK_OF_YEAR
MONTH_OF_YEAR
PROLEPTIC_MONTH
YEAR_OF_ERA
YEAR
ERA
ChronoField
экземпляры возвратят false. Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.isSupportedBy(TemporalAccessor)
передача this
как параметр. Поддерживается ли поле, определяется полем.
isSupported
в интерфейсе ChronoLocalDateTime<LocalDate>
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
, EPOCH_DAY
и PROLEPTIC_MONTH
которые являются слишком большими, чтобы вписаться 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 LocalDate toLocalDate()
LocalDate
часть этого разового датой. Это возвращает a LocalDate
с тем же самым годом, месяцем и днем как это разовое датой.
toLocalDate
в интерфейсе ChronoLocalDateTime<LocalDate>
public int getYear()
Этот метод возвращает примитив int
значение в течение года.
Год, возвращенный этим методом, является преждевременным согласно get(YEAR)
. Чтобы получить год эры, использовать get(YEAR_OF_ERA)
.
public int getMonthValue()
Этот метод возвращает месяц как int
от 1 до 12. Код программы является часто более четким если перечисление Month
используется, вызывая getMonth()
.
getMonth()
public Month getMonth()
Month
перечисление. Этот метод возвращает перечисление Month
в течение месяца. Это избегает беспорядка относительно какой int
среднее значение значений. Если Вы нуждаетесь в доступе к примитиву int
значение тогда перечисление обеспечивает int value
.
getMonthValue()
public int getDayOfMonth()
Этот метод возвращает примитив int
значение в течение дня-месячного.
public int getDayOfYear()
Этот метод возвращает примитив int
значение в течение дня-летнего.
public DayOfWeek getDayOfWeek()
DayOfWeek
. Этот метод возвращает перечисление DayOfWeek
в течение дня-недельного. Это избегает беспорядка относительно какой int
среднее значение значений. Если Вы нуждаетесь в доступе к примитиву int
значение тогда перечисление обеспечивает int value
.
Дополнительная информация может быть получена из DayOfWeek
. Это включает текстовые имена значений.
public LocalTime toLocalTime()
LocalTime
часть этого разового датой. Это возвращает a LocalTime
с тем же самым часом, минутой, второй и наносекунда как это разовое датой.
toLocalTime
в интерфейсе ChronoLocalDateTime<LocalDate>
public int getHour()
public int getMinute()
public int getSecond()
public int getNano()
public LocalDateTime with(TemporalAdjuster adjuster)
Это возвращает a LocalDateTime
, основанный на этом, со скорректированным разовым датой. Корректировка имеет место, используя указанный объект стратегии регулятора. Считайте документацию регулятора, чтобы понять, какая корректировка будет внесена.
Простой регулятор мог бы просто установить то из полей, таких как поле года. Более сложный регулятор мог бы назначить дату к прошлому дню месяца. В выборе общих корректировок обеспечивают TemporalAdjuster
. Они включают обнаружение "в последний день месяца" и "следующей среды". Разовые основным сроком классы также реализуют TemporalAdjuster
интерфейс, такой как Month
и MonthDay
. Регулятор ответственен за обработку особых случаев, таких как переменные продолжительности месяца и високосных годов.
Например этот код возвращает дату в прошлый день июля:
import static java.time.Month.*; import static java.time.temporal.Adjusters.*; result = localDateTime.with(JULY).with(lastDayOfMonth());
Классы LocalDate
и LocalTime
реализация TemporalAdjuster
, таким образом этот метод может использоваться, чтобы изменить дату, время или сместить:
result = localDateTime.with(date); result = localDateTime.with(time);
Результат этого метода получается, вызывая TemporalAdjuster.adjustInto(Temporal)
метод на указанной передаче регулятора this
как параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе ChronoLocalDateTime<LocalDate>
with
в интерфейсе Temporal
adjuster
- регулятор, чтобы использовать, не нульLocalDateTime
основанный на this
с внесенной корректировкой, не нульDateTimeException
- если корректировка не может быть внесенаArithmeticException
- если числовое переполнение происходитpublic LocalDateTime with(TemporalField field, long newValue)
Это возвращает a LocalDateTime
, основанный на этом, со значением для указанного поля изменился. Это может использоваться, чтобы изменить любое поддерживаемое поле, такое как год, месяц или день-месячного. Если не возможно установить значение, потому что поле не поддерживается или по некоторой другой причине, исключение выдается.
В некоторых случаях изменение указанного поля может заставить получающееся разовое датой становиться недопустимым, такие как изменение месяца с 31-ого января до февраля сделал бы день-месячного недопустимым. В случаях как это поле ответственно за разрешение даты. Обычно это выберет предыдущую допустимую дату, которая была бы прошлым допустимым днем февраля в этом примере.
Если поле является a ChronoField
тогда корректировка реализуется здесь. supported fields
будет вести себя согласно соответствующему методу на LocalDate
или LocalTime
. Все другой ChronoField
экземпляры бросят UnsupportedTemporalTypeException
.
Если поле не является a ChronoField
, тогда результат этого метода получается, вызывая TemporalField.adjustInto(Temporal, long)
передача this
как параметр. В этом случае поле определяет, ли и как скорректировать момент.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
with
в интерфейсе ChronoLocalDateTime<LocalDate>
with
в интерфейсе Temporal
field
- поле, чтобы установить в результате, не нулеnewValue
- новое значение поля в результатеLocalDateTime
основанный на this
с указанным полевым набором, не нулемDateTimeException
- если поле не может быть установленоUnsupportedTemporalTypeException
- если поле не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalDateTime withYear(int year)
LocalDateTime
с измененным годом. Время не влияет на вычисление и будет тем же самым в результате. Если день-месячного будет недопустим в течение года, то он будет изменен на прошлый допустимый день месяца. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
year
- год, чтобы установить в результате, от MIN_YEAR до MAX_YEARLocalDateTime
основанный на этом разовом датой с требуемым годом, не нулемDateTimeException
- если значение года недопустимоpublic LocalDateTime withMonth(int month)
LocalDateTime
с измененным месяцем-летнего. Время не влияет на вычисление и будет тем же самым в результате. Если день-месячного будет недопустим в течение года, то он будет изменен на прошлый допустимый день месяца. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
month
- месяц-летнего, чтобы установить в результате, от 1 (январь) к 12 (декабрь)LocalDateTime
основанный на этом разовом датой с требуемым месяцем, не нулемDateTimeException
- если значение месяца-летнего недопустимоpublic LocalDateTime withDayOfMonth(int dayOfMonth)
LocalDateTime
с измененным днем-месячного. Если получающееся LocalDateTime
недопустимо, исключение выдается. Время не влияет на вычисление и будет тем же самым в результате. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
dayOfMonth
- день-месячного, чтобы установить в результате, от 1 до 28-31LocalDateTime
основанный на этом разовом датой с требуемым днем, не нулемDateTimeException
- если дневное-месячного значение недопустимо, или если день-месячного недопустим для летнего месяцемpublic LocalDateTime withDayOfYear(int dayOfYear)
LocalDateTime
с измененным днем-летнего. Если получающееся LocalDateTime
недопустимо, исключение выдается. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
dayOfYear
- день-летнего, чтобы установить в результате, от 1 до 365-366LocalDateTime
основанный на этой дате с требуемым днем, не нулеDateTimeException
- если дневное-летнего значение недопустимо, или если день-летнего недопустим в течение годаpublic LocalDateTime withHour(int hour)
LocalDateTime
с измененным значением часа-дневного. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hour
- час-дневного, чтобы установить в результате, от 0 до 23LocalDateTime
основанный на этом разовом датой с требуемым часом, не нулемDateTimeException
- если значение часа недопустимоpublic LocalDateTime withMinute(int minute)
LocalDateTime
с мелким-часового измененным значением. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minute
- минута-часового, чтобы установить в результате, от 0 до 59LocalDateTime
основанный на этом разовом датой с требуемой минутой, не нулемDateTimeException
- если мелкое значение недопустимоpublic LocalDateTime withSecond(int second)
LocalDateTime
со вторым-минутного измененным значением. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
second
- второе-минутного, чтобы установить в результате, от 0 до 59LocalDateTime
основанный на этом разовом датой с требуемой секундой, не нулевойDateTimeException
- если второе значение недопустимоpublic LocalDateTime withNano(int nanoOfSecond)
LocalDateTime
с измененным значением nano-of-second. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanoOfSecond
- nano-of-second, чтобы установить в результате, от 0 до 999 999 999LocalDateTime
основанный на этом разовом датой с требуемой наносекундой, не нулемDateTimeException
- если значение nano недопустимоpublic LocalDateTime truncatedTo(TemporalUnit unit)
LocalDateTime
с усеченным временем. Усечение возвращает копию оригинала, разового датой с полями, меньшими чем указанный обнуленный модуль. Например, усечение с minutes
модуль обнулит второе-минутного и nano-of-second поле.
У модуля должна быть продолжительность, которая делится на продолжительность стандартного дня без остатка. Это включает все предоставленные единицы измерения времени на ChronoUnit
и DAYS
. Другие модули выдают исключение.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
unit
- модуль, чтобы усечь к, не нульLocalDateTime
основанный на этом разовом датой с усеченным временем, не нулевойDateTimeException
- если неспособный усекатьUnsupportedTemporalTypeException
- если поле не поддерживаетсяpublic LocalDateTime plus(TemporalAmount amountToAdd)
Это возвращает a LocalDateTime
, основанный на этом, с указанным добавленным количеством. Количество обычно Period
или Duration
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.addTo(Temporal)
. Реализация количества свободна реализовать дополнение всегда, это желает, однако это обычно перезванивает к plus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно добавлено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе ChronoLocalDateTime<LocalDate>
plus
в интерфейсе Temporal
amountToAdd
- количество, чтобы добавить, не нульLocalDateTime
основанный на этом разовом датой со сделанным дополнением, не нульDateTimeException
- если дополнение не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic LocalDateTime plus(long amountToAdd, TemporalUnit unit)
Это возвращает a LocalDateTime
, основанный на этом, с количеством с точки зрения модуля добавил. Если не возможно добавить количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Если поле является a ChronoUnit
тогда дополнение реализуется здесь. Модули даты добавляются согласно LocalDate.plus(long, TemporalUnit)
. Единицы измерения времени добавляются согласно LocalTime.plus(long, TemporalUnit)
с любым переполнением в днях добавленный эквивалент использованию plusDays(long)
.
Если поле не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.addTo(Temporal, long)
передача this
как параметр. В этом случае модуль определяет, ли и как выполнить дополнение.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
plus
в интерфейсе ChronoLocalDateTime<LocalDate>
plus
в интерфейсе Temporal
amountToAdd
- количество модуля, чтобы добавить к результату, может быть отрицательнымunit
- модуль количества, чтобы добавить, не нульLocalDateTime
основанный на этом разовом датой с указанным количеством добавил, не нульDateTimeException
- если дополнение не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalDateTime plusYears(long years)
LocalDateTime
с установленным периодом в добавленных годах. Этот метод добавляет указанное количество к полю лет в трех шагах:
Например, 29.02.2008 (високосный год) плюс один год привел бы к недопустимой дате 29.02.2009 (стандартный год). Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 28.02.2009, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
years
- годы, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с годами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusMonths(long months)
LocalDateTime
с установленным периодом в добавленных месяцах. Этот метод добавляет указанное количество к полю месяцев в трех шагах:
Например, 31.03.2007 плюс один месяц привел бы к недопустимой дате 31.04.2007. Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 30.04.2007, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
months
- месяцы, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с месяцами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusWeeks(long weeks)
LocalDateTime
с установленным периодом в добавленных неделях. Этот метод добавляет указанное количество в неделях к дневному полю, постепенно увеличивающему поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 31.12.2008 плюс одна неделя закончился бы в 07.01.2009.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
weeks
- недели, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с неделями добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusDays(long days)
LocalDateTime
с установленным периодом в добавленных днях. Этот метод добавляет указанное количество к дневному полю, постепенно увеличивающему поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 31.12.2008 плюс один день закончился бы в 01.01.2009.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
days
- дни, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой со днями добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusHours(long hours)
LocalDateTime
с установленным периодом в добавленных часах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hours
- часы, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с часами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusMinutes(long minutes)
LocalDateTime
с установленным периодом в добавленных минутах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minutes
- минуты, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с минутами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusSeconds(long seconds)
LocalDateTime
с установленным периодом в добавленных секундах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
seconds
- секунды, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с секундами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime plusNanos(long nanos)
LocalDateTime
с установленным периодом в добавленных наносекундах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanos
- nanos, чтобы добавить, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с наносекундами добавил, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minus(TemporalAmount amountToSubtract)
Это возвращает a LocalDateTime
, основанный на этом, с указанным вычтенным количеством. Количество обычно Period
или Duration
но может быть любой другой тип, реализовывая TemporalAmount
интерфейс.
Вычисление делегируется к объекту количества, вызывая TemporalAmount.subtractFrom(Temporal)
. Реализация количества свободна реализовать вычитание всегда, это желает, однако это обычно перезванивает к minus(long, TemporalUnit)
. Консультируйтесь с документацией реализации количества, чтобы определить, может ли это быть успешно вычтено.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе ChronoLocalDateTime<LocalDate>
minus
в интерфейсе Temporal
amountToSubtract
- количество, чтобы вычесть, не нульLocalDateTime
основанный на этом разовом датой со сделанным вычитанием, не нульDateTimeException
- если вычитание не может быть сделаноArithmeticException
- если числовое переполнение происходитpublic LocalDateTime minus(long amountToSubtract, TemporalUnit unit)
Это возвращает a LocalDateTime
, основанный на этом, с количеством с точки зрения модуля вычитается. Если не возможно вычесть количество, потому что модуль не поддерживается или по некоторой другой причине, исключение выдается.
Этот метод эквивалентен plus(long, TemporalUnit)
с отрицаемым количеством. См., что метод для полного описания того, как дополнение, и таким образом вычитание, работают.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minus
в интерфейсе ChronoLocalDateTime<LocalDate>
minus
в интерфейсе Temporal
amountToSubtract
- количество модуля, чтобы вычесть из результата, может быть отрицательнымunit
- модуль количества, чтобы вычесть, не нульLocalDateTime
основанный на этом разовом датой с указанным вычтенным количеством, не нульDateTimeException
- если вычитание не может быть сделаноUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic LocalDateTime minusYears(long years)
LocalDateTime
с установленным периодом в вычтенных годах. Этот метод вычитает указанное количество из поля лет в трех шагах:
Например, 29.02.2008 (високосный год) минус один год привел бы к недопустимой дате 29.02.2009 (стандартный год). Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 28.02.2009, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
years
- годы, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными годами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusMonths(long months)
LocalDateTime
с установленным периодом в вычтенных месяцах. Этот метод вычитает указанное количество из поля месяцев в трех шагах:
Например, 31.03.2007 минус один месяц привел бы к недопустимой дате 31.04.2007. Вместо того, чтобы возвратить недопустимый результат, прошлый допустимый день месяца, 30.04.2007, выбирается вместо этого.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
months
- месяцы, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными месяцами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusWeeks(long weeks)
LocalDateTime
с установленным периодом в вычтенных неделях. Этот метод вычитает указанное количество в неделях от дневного поля, постепенно уменьшающего поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 07.01.2009 минус одна неделя закончился бы в 31.12.2008.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
weeks
- недели, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными неделями, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusDays(long days)
LocalDateTime
с установленным периодом в вычтенных днях. Этот метод вычитает указанное количество из дневного поля, постепенно увеличивающего поля месяца и года по мере необходимости, чтобы гарантировать, что результат остается допустимым. Результат только недопустим, если максимальный/минимальный год превышается.
Например, 01.01.2009 минус один день закончился бы в 31.12.2008.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
days
- дни, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными днями, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusHours(long hours)
LocalDateTime
с установленным периодом в вычтенных часах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
hours
- часы, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными часами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusMinutes(long minutes)
LocalDateTime
с установленным периодом в вычтенных минутах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
minutes
- минуты, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными минутами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusSeconds(long seconds)
LocalDateTime
с установленным периодом в вычтенных секундах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
seconds
- секунды, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными секундами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic LocalDateTime minusNanos(long nanos)
LocalDateTime
с установленным периодом в вычтенных наносекундах. Этот экземпляр является неизменным и незатронутым этим вызовом метода.
nanos
- nanos, чтобы вычесть, может быть отрицательнымLocalDateTime
основанный на этом разовом датой с вычтенными наносекундами, не нульDateTimeException
- если результат превышает поддерживаемый диапазон датpublic <R> R query(TemporalQuery<R> query)
Это запрашивает это разовое датой использование указанного объекта стратегии запроса. TemporalQuery
объект определяет логику, которая будет использоваться, чтобы получить результат. Считайте документацию запроса, чтобы понять, каков результат этого метода будет.
Результат этого метода получается, вызывая TemporalQuery.queryFrom(TemporalAccessor)
метод на указанной передаче запроса this
как параметр.
query
в интерфейсе ChronoLocalDateTime<LocalDate>
query
в интерфейсе TemporalAccessor
R
- тип результатаquery
- запрос, чтобы вызвать, не нульDateTimeException
- если неспособный запрашивать (определенный запросом)ArithmeticException
- если числовое переполнение происходит (определенный запросом)public Temporal adjustInto(Temporal temporal)
Это возвращает временный объект того же самого заметного типа как ввод с датой и время, измененное, чтобы быть тем же самым как этим.
Корректировка эквивалентна использованию Temporal.with(TemporalField, long)
дважды, передача ChronoField.EPOCH_DAY
и ChronoField.NANO_OF_DAY
как поля.
В большинстве случаев это является более четким, чтобы инвертировать образец вызова при использовании Temporal.with(TemporalAdjuster)
:
// these two lines are equivalent, but the second approach is recommended temporal = thisLocalDateTime.adjustInto(temporal); temporal = temporal.with(thisLocalDateTime);
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
adjustInto
в интерфейсе ChronoLocalDateTime<LocalDate>
adjustInto
в интерфейсе TemporalAdjuster
temporal
- целевой объект, который будет скорректирован, не нульDateTimeException
- если неспособный вносить корректировкуArithmeticException
- если числовое переполнение происходитpublic long periodUntil(Temporal endDateTime, TemporalUnit unit)
Это вычисляет количество времени между два LocalDateTime
объекты с точки зрения сингла TemporalUnit
. Запуск и конечные точки this
и указанное разовое датой. Результат будет отрицателен, если конец будет перед запуском. Temporal
переданный к этому методу должен быть a LocalDateTime
. Например, количество в днях между двумя разами может быть вычислено, используя startDateTime.periodUntil(endDateTime, DAYS)
.
Вычисление возвращает целое число, представляя число полных модулей между этими двумя разами. Например, количество в месяцах между 2012-06-15T00:00 и 2012-08-14T23:59 только будет одним месяцем, поскольку это - одна минута за исключением двух месяцев.
Есть два эквивалентных способа использовать этот метод. Первое должно вызвать этот метод. Второе должно использовать TemporalUnit.between(Temporal, Temporal)
:
// these two lines are equivalent amount = start.periodUntil(end, MONTHS); amount = MONTHS.between(start, end);Выбор должен быть сделан основанный, которого делает код более читаемым.
Вычисление реализуется в этом методе для ChronoUnit
. Модули NANOS
, MICROS
, MILLIS
, SECONDS
, MINUTES
, HOURS
и HALF_DAYS
, DAYS
, WEEKS
, MONTHS
, YEARS
, DECADES
, CENTURIES
, MILLENNIA
и ERAS
поддерживаются. Другой ChronoUnit
значения выдадут исключение.
Если модуль не является a ChronoUnit
, тогда результат этого метода получается, вызывая TemporalUnit.between(Temporal, Temporal)
передача this
как первый параметр и ввод, временный как второй параметр.
Этот экземпляр является неизменным и незатронутым этим вызовом метода.
periodUntil
в интерфейсе Temporal
endDateTime
- разовое датой окончания, которое должно быть a LocalDateTime
, не нульunit
- модуль, чтобы измерить количество в, не нульDateTimeException
- если количество не может быть вычисленоUnsupportedTemporalTypeException
- если модуль не поддерживаетсяArithmeticException
- если числовое переполнение происходитpublic String format(DateTimeFormatter formatter)
Это разовое датой передадут к средству форматирования, чтобы произвести строку.
format
в интерфейсе ChronoLocalDateTime<LocalDate>
formatter
- средство форматирования, чтобы использовать, не нульDateTimeException
- если ошибка происходит во время печатиpublic OffsetDateTime atOffset(ZoneOffset offset)
OffsetDateTime
. Это возвращается OffsetDateTime
сформированный из этого разового датой при указанном смещении. Все возможные комбинации разовых датой и смещения допустимы.
offset
- смещение, чтобы объединить с, не нульpublic ZonedDateTime atZone(ZoneId zone)
ZonedDateTime
. Это возвращает a ZonedDateTime
сформированный из этого разового датой в указанном часовом поясе. Результат будет соответствовать это разовое датой настолько близко насколько возможно. Правила часового пояса, такие как переход на летнее время, означают, что не каждая разовая датой локальная переменная допустима для указанной зоны, таким образом разовая датой локальная переменная может быть скорректирована.
Разовая датой локальная переменная разрешается к единственному моменту на временной шкале. Это достигается, находя допустимое смещение от UTC/Гринвича для локальной переменной, разовой датой как определено rules
из зонального ID.
В большинстве случаев есть только одно допустимое смещение для разовой датой локальной переменной. В случае перекрытия, где часы задерживаются, есть два допустимых смещения. Этот метод использует ранее смещение, обычно соответствующее "лету".
В случае разрыва, где часы переходят вперед, нет никакого допустимого смещения. Вместо этого разовая датой локальная переменная корректируется, чтобы быть позже длиной разрыва. Для изменения перехода на летнее время типичного одного часа разовая датой локальная переменная будет перемещена один час спустя в смещение, обычно соответствующее "лету".
Чтобы получить более позднее смещение во время перекрытия, вызвать ZonedDateTime.withLaterOffsetAtOverlap()
на результате этого метода. Чтобы выдать исключение, когда есть разрыв или перекрытие, использовать ZonedDateTime.ofStrict(LocalDateTime, ZoneOffset, ZoneId)
.
atZone
в интерфейсе ChronoLocalDateTime<LocalDate>
zone
- часовой пояс, чтобы использовать, не нульpublic int compareTo(ChronoLocalDateTime<?> other)
Сравнение прежде всего основано на разовом датой от самого раннего до последнего. Это является "непротиворечивым с, равняется", как определено Comparable
.
Если все сравниваемые времена даты являются экземплярами LocalDateTime
, тогда сравнение будет полностью основано на разовом датой. Если некоторые сравниваемые даты находятся в различных хронологиях, то хронологию также рассматривают, см. ChronoLocalDateTime.compareTo(java.time.chrono.ChronoLocalDateTime<?>)
.
compareTo
в интерфейсе Comparable<ChronoLocalDateTime<?>>
compareTo
в интерфейсе ChronoLocalDateTime<LocalDate>
other
- другое разовое датой, чтобы сравнить с, не нульpublic boolean isAfter(ChronoLocalDateTime<?> other)
Это проверяет, чтобы видеть, представляет ли это разовое датой точку на локальной временной шкале после другое разовое датой.
LocalDate a = LocalDateTime.of(2012, 6, 30, 12, 00); LocalDate b = LocalDateTime.of(2012, 7, 1, 12, 00); a.isAfter(b) == false a.isAfter(a) == false b.isAfter(a) == true
Этот метод только рассматривает позицию этих двух раз на локальной временной шкале. Это не принимает во внимание хронологию, или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDateTime)
, но тот же самый подход как ChronoLocalDateTime.timeLineOrder()
.
isAfter
в интерфейсе ChronoLocalDateTime<LocalDate>
other
- другое разовое датой, чтобы сравнить с, не нульpublic boolean isBefore(ChronoLocalDateTime<?> other)
Это проверяет, чтобы видеть, представляет ли это разовое датой точку на локальной временной шкале перед другое разовое датой.
LocalDate a = LocalDateTime.of(2012, 6, 30, 12, 00); LocalDate b = LocalDateTime.of(2012, 7, 1, 12, 00); a.isBefore(b) == true a.isBefore(a) == false b.isBefore(a) == false
Этот метод только рассматривает позицию этих двух раз на локальной временной шкале. Это не принимает во внимание хронологию, или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDateTime)
, но тот же самый подход как ChronoLocalDateTime.timeLineOrder()
.
isBefore
в интерфейсе ChronoLocalDateTime<LocalDate>
other
- другое разовое датой, чтобы сравнить с, не нульpublic boolean isEqual(ChronoLocalDateTime<?> other)
Это проверяет, чтобы видеть, представляет ли это разовое датой ту же самую точку на локальной временной шкале как другое разовое датой.
LocalDate a = LocalDateTime.of(2012, 6, 30, 12, 00); LocalDate b = LocalDateTime.of(2012, 7, 1, 12, 00); a.isEqual(b) == false a.isEqual(a) == true b.isEqual(a) == false
Этот метод только рассматривает позицию этих двух раз на локальной временной шкале. Это не принимает во внимание хронологию, или календарную систему. Это отличается от сравнения в compareTo(ChronoLocalDateTime)
, но тот же самый подход как ChronoLocalDateTime.timeLineOrder()
.
isEqual
в интерфейсе ChronoLocalDateTime<LocalDate>
other
- другое разовое датой, чтобы сравнить с, не нульpublic boolean equals(Object obj)
Сравнивает это LocalDateTime
с другим обеспечением, что разовым датой является то же самое. Только объекты типа LocalDateTime
сравниваются, другие типы возвращают false.
equals
в интерфейсе ChronoLocalDateTime<LocalDate>
equals
в class Object
obj
- объект проверить, обнулите, возвращает falseObject.hashCode()
, HashMap
public int hashCode()
hashCode
в интерфейсе ChronoLocalDateTime<LocalDate>
hashCode
в class Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public String toString()
String
, такой как 2007-12-03T10:15:30
. Вывод будет одним из следующих форматов ISO 8601:
uuuu-MM-dd'T'HH:mm
uuuu-MM-dd'T'HH:mm:ss
uuuu-MM-dd'T'HH:mm:ss.SSS
uuuu-MM-dd'T'HH:mm:ss.SSSSSS
uuuu-MM-dd'T'HH:mm:ss.SSSSSSSSS
Используемый формат будет самым коротким, который выводит полную стоимость времени, где опущенные части подразумеваются, чтобы быть нулем.
toString
в интерфейсе ChronoLocalDateTime<LocalDate>
toString
в class Object
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92