Класс OffsetDateTime

public static final OffsetDateTime MIN

public static final OffsetDateTime MAX

public static Comparator<OffsetDateTime> timeLineOrder()

Возвращает компаратор, который сравнивает две OffsetDateTime сущности только по моменту времени.

Этот метод отличается от сравнения в compareTo(java.time.OffsetDateTime) тем, что сравнивает только базовый момент времени.

public static OffsetDateTime now()

Получает текущую дату-время из системных часов в часовом поясе по умолчанию.

Это запросит system clock в часовом поясе по умолчанию, чтобы получить текущую дату-время. Смещение будет вычислено из часового пояса в часах.

Использование этого метода предотвратит возможность использования альтернативных часов для тестирования, потому что часы жёстко закодированы.

public static OffsetDateTime now(ZoneId zone)

Получает текущую дату-время из системных часов в указанном часовом поясе.

Это запросит system clock, чтобы получить текущую дату-время. Указание часового пояса предотвращает зависимость от часового пояса по умолчанию. Смещение будет вычислено из указанного часового пояса.

Использование этого метода предотвратит возможность использования альтернативных часов для тестирования, потому что часы жёстко закодированы.

public static OffsetDateTime now(Clock clock)

Получает текущую дату-время из указанных часов.

Это запросит указанные часы, чтобы получить текущую дату-время. Смещение будет вычислено из часового пояса в часах.

Использование этого метода позволяет использовать альтернативные часы для тестирования. Альтернативные часы могут быть введены с помощью dependency injection.

public static OffsetDateTime of(LocalDate date,
                                LocalTime time,
                                ZoneOffset offset)

Получает экземпляр OffsetDateTime из даты, времени и смещения.

Это создаёт дату-время со смещением с указанной локальной датой, временем и смещением.

public static OffsetDateTime of(LocalDateTime dateTime,
                                ZoneOffset offset)

Получает экземпляр OffsetDateTime из даты-времени и смещения.

Это создаёт дату-время со смещением с указанной локальной датой-временем и смещением.

public static OffsetDateTime of(int year,
                                int month,
                                int dayOfMonth,
                                int hour,
                                int minute,
                                int second,
                                int nanoOfSecond,
                                ZoneOffset offset)

Получает экземпляр OffsetDateTime из года, месяца, дня, часа, минуты, секунды, наносекунды и смещения.

Это создаёт дату-время со смещением с семью указанными полями.

Этот метод предназначен в основном для написания тестовых случаев. Вне тестов обычно используются другие методы для создания даты-времени со смещением. LocalDateTime имеет пять дополнительных удобных вариантов эквивалентного фабричного метода с меньшим количеством аргументов. Они не представлены здесь для уменьшения объёма API.

public static OffsetDateTime ofInstant(Instant instant,
                                       ZoneId zone)

Получает экземпляр OffsetDateTime из Instant и идентификатора часового пояса.

Это создаёт дату-время со смещением с тем же мгновением, что и указанное. Определение смещения от UTC/Гринвича простое, поскольку для каждого мгновения существует только одно допустимое смещение.

public static OffsetDateTime from(TemporalAccessor temporal)

Получает экземпляр OffsetDateTime из временного объекта.

Это получает дату-время со смещением на основе указанного временного объекта. TemporalAccessor представляет собой произвольный набор информации о дате и времени, который эта фабрика преобразует в экземпляр OffsetDateTime.

Преобразование сначала получит ZoneOffset из временного объекта. Затем попытается получить LocalDateTime, при необходимости перейдя к Instant. Результат будет комбинацией ZoneOffset с LocalDateTime или Instant.

Этот метод соответствует сигнатуре функционального интерфейса TemporalQuery, позволяя использовать его в качестве запроса через ссылку на метод, OffsetDateTime::from.

public static OffsetDateTime parse(CharSequence text)

Получает экземпляр OffsetDateTime из текстовой строки, такой как 2007-12-03T10:15:30+01:00.

Строка должна представлять собой допустимую дату-время и анализируется с помощью DateTimeFormatter.ISO_OFFSET_DATE_TIME.

public static OffsetDateTime parse(CharSequence text,
                                   DateTimeFormatter formatter)

Получает экземпляр OffsetDateTime из текстовой строки с использованием определённого форматера.

Текст анализируется с помощью форматера, возвращая дату-время.

public boolean isSupported(TemporalField field)

Проверяет, поддерживается ли указанное поле.

Это проверяет, можно ли запросить значение указанного поля для этой даты и времени. Если false, то вызов методов range, get и with(TemporalField, long) вызовет исключение.

Если поле является 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
• INSTANT_SECONDS
• OFFSET_SECONDS

Все остальные ChronoField возвращают false.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.isSupportedBy(TemporalAccessor) с this в качестве аргумента. Поддерживается ли поле, определяется самим полем.

public boolean isSupported(TemporalUnit unit)

Проверяет, поддерживается ли указанный интервал.

Это проверяет, можно ли добавить или вычесть указанный интервал из этой даты и времени. Если false, то вызов методов plus(long, TemporalUnit) и minus вызовет исключение.

Если интервал является ChronoUnit, то запрос реализуется здесь. Поддерживаемые интервалы:

• NANOS
• MICROS
• MILLIS
• SECONDS
• MINUTES
• HOURS
• HALF_DAYS
• DAYS
• WEEKS
• MONTHS
• YEARS
• DECADES
• CENTURIES
• MILLENNIA
• ERAS

Все остальные ChronoUnit возвращают false.

Если интервал не является ChronoUnit, то результат этого метода получается путем вызова TemporalUnit.isSupportedBy(Temporal) с this в качестве аргумента. Поддерживается ли интервал, определяется им самим.

public ValueRange range(TemporalField field)

Получает диапазон допустимых значений для указанного поля.

Объект диапазона выражает минимальное и максимальное допустимые значения для поля. Эта дата и время используются для повышения точности возвращаемого диапазона. Если невозможно вернуть диапазон, потому что поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoField, то запрос реализуется здесь. supported fields вернет соответствующие экземпляры диапазона. Все остальные ChronoField экземпляры выбросят исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.rangeRefinedBy(TemporalAccessor) с this в качестве аргумента. Возможен ли запрос диапазона, определяется полем.

public int get(TemporalField field)

Получает значение указанного поля из этой даты и времени как int.

Это запрос значения указанного поля для этой даты и времени. Возвращаемое значение всегда будет находиться в пределах допустимого диапазона значений для поля. Если невозможно вернуть значение, потому что поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoField, то запрос реализуется здесь. supported fields вернет допустимые значения на основе этой даты и времени, за исключением NANO_OF_DAY, MICRO_OF_DAY, EPOCH_DAY, PROLEPTIC_MONTH и INSTANT_SECONDS, которые слишком велики для хранения в int и вызовут исключение DateTimeException. Все остальные ChronoField экземпляры выбросят исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.getFrom(TemporalAccessor) с this в качестве аргумента. Возможно ли получить значение и что оно представляет, определяется полем.

public long getLong(TemporalField field)

Получает значение указанного поля из этой даты и времени как long.

Это запрос значения указанного поля для этой даты и времени. Если невозможно вернуть значение, потому что поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoField, то запрос реализуется здесь. supported fields вернет допустимые значения на основе этой даты и времени. Все остальные ChronoField экземпляры выбросят исключение UnsupportedTemporalTypeException.

Если поле не является ChronoField, то результат этого метода получается путем вызова TemporalField.getFrom(TemporalAccessor) с this в качестве аргумента. Возможно ли получить значение и что оно представляет, определяется полем.

public ZoneOffset getOffset()

Получает смещение часового пояса, например '+01:00'.

Это смещение локальной даты и времени от UTC/Гринвича.

public OffsetDateTime withOffsetSameLocal(ZoneOffset offset)

Возвращает копию этого OffsetDateTime со специфицированным смещением, гарантируя, что результат имеет ту же локальную дату и время.

Этот метод возвращает объект с тем же LocalDateTime и указанным ZoneOffset. Вычисления не требуются и не выполняются. Например, если это время представляет 2007-12-03T10:30+02:00 и указанное смещение - +03:00, тогда этот метод вернет 2007-12-03T10:30+03:00.

Чтобы учесть разницу во времени и скорректировать поля времени, используйте withOffsetSameInstant(java.time.ZoneOffset).

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withOffsetSameInstant(ZoneOffset offset)

Возвращает копию этого OffsetDateTime со специфицированным смещением, гарантируя, что результат находится в то же мгновение.

Этот метод возвращает объект с указанным ZoneOffset и LocalDateTime скорректированным на разницу между двумя смещениями. Это приведет к тому, что старый и новый объекты будут представлять одно и то же мгновение. Это полезно для нахождения локального времени в другом часовом поясе. Например, если это время представляет 2007-12-03T10:30+02:00 и указанное смещение - +03:00, тогда этот метод вернет 2007-12-03T11:30+03:00.

Чтобы изменить смещение без корректировки локального времени, используйте withOffsetSameLocal(java.time.ZoneOffset).

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public LocalDateTime toLocalDateTime()

Получает LocalDateTime часть этой даты и времени.

Возвращает LocalDateTime с тем же годом, месяцем, днём и временем, что и у этой даты и времени.

public LocalDate toLocalDate()

Получает LocalDate часть этой даты и времени.

Возвращает LocalDate с тем же годом, месяцем и днём, что и у этой даты и времени.

public int getYear()

Получает поле года.

Этот метод возвращает примитивное значение int для года.

Год, возвращаемый этим методом, является пролептическим в соответствии с get(YEAR). Чтобы получить год эры, используйте get(YEAR_OF_ERA).

public int getMonthValue()

Получает поле месяца года от 1 до 12.

Этот метод возвращает месяц как int от 1 до 12. Код приложения часто становится понятнее, если использовать перечисление Month, вызывая getMonth().

public Month getMonth()

Получает поле месяца года, используя перечисление Month.

Этот метод возвращает перечисление Month для месяца. Это помогает избежать путаницы в значении int значений. Если вам нужен доступ к примитивному значению int, то перечисление предоставляет int value.

public int getDayOfMonth()

Получает поле дня месяца.

Этот метод возвращает примитивное int значение для дня месяца.

public int getDayOfYear()

Получает поле дня года.

Этот метод возвращает примитивное int значение для дня года.

public DayOfWeek getDayOfWeek()

Получает поле дня недели, которое является перечислением DayOfWeek.

Этот метод возвращает перечисление DayOfWeek для дня недели. Это помогает избежать путаницы в значении int значений. Если вам нужен доступ к примитивному int значению, то перечисление предоставляет int value.

Дополнительная информация может быть получена из DayOfWeek. Это включает текстовые имена значений.

public LocalTime toLocalTime()

Получает LocalTime часть этой даты и времени.

Возвращает LocalTime с тем же часом, минутой, секундой и наносекундой, что и у этой даты и времени.

public int getHour()

public int getMinute()

public int getSecond()

public int getNano()

public OffsetDateTime with(TemporalAdjuster adjuster)

Возвращает скопированное изменённое значение этой даты и времени.

Возвращает OffsetDateTime, основанное на этом, со скорректированным значением даты и времени. Коррекция выполняется с использованием указанного объекта стратегии корректировки. Прочитайте документацию корректировщика, чтобы понять, какие изменения будут сделаны.

Простой корректировщик может просто установить одно из полей, например, поле года. Более сложный корректировщик может установить дату на последнее число месяца. Выбор общих корректировок представлен в TemporalAdjusters. К ним относятся нахождение "последнего дня месяца" и "следующей среды". Основные классы даты и времени также реализуют интерфейс TemporalAdjuster, такие как Month и MonthDay. Корректировщик отвечает за обработку особых случаев, таких как различные длины месяцев и високосных лет.

Например, этот код возвращает дату последнего дня июля:

import static java.time.Month.*;
  import static java.time.temporal.TemporalAdjusters.*;

  result = offsetDateTime.with(JULY).with(lastDayOfMonth());

Классы LocalDate, LocalTime и ZoneOffset реализуют TemporalAdjuster, поэтому этот метод может использоваться для изменения даты, времени или смещения:

result = offsetDateTime.with(date);
  result = offsetDateTime.with(time);
  result = offsetDateTime.with(offset);

Результат этого метода получается путём вызова метода TemporalAdjuster.adjustInto(Temporal) на указанном корректировщике, передавая this в качестве аргумента.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime with(TemporalField field,
                           long newValue)

Возвращает копию этой даты и времени с указанным полем, установленным на новое значение.

Возвращает OffsetDateTime, основанное на этом, со значением указанного поля изменённым. Это можно использовать для изменения любого поддерживаемого поля, например, года, месяца или дня месяца. Если значение нельзя установить, потому что поле не поддерживается или по какой-либо другой причине, выбрасывается исключение.

В некоторых случаях изменение указанного поля может привести к тому, что результирующая дата и время станут недействительными, например, изменение месяца с 31 января на февраль сделает день месяца недействительным. В таких случаях поле отвечает за разрешение даты. Обычно оно выберет предыдущую корректную дату, которая в этом примере будет последним днём февраля.

Если поле является ChronoField, то корректировка реализуется здесь.

Поле INSTANT_SECONDS вернёт дату и время с указанным моментом. Смещение и наносекунды не изменятся. Если новое значение момента выходит за допустимый диапазон, будет выброшено DateTimeException.

Поле OFFSET_SECONDS вернёт дату и время с указанным смещением. Локальная дата и время не изменятся. Если новое значение смещения выходит за допустимый диапазон, будет выброшено DateTimeException.

Другие supported fields будут вести себя в соответствии с соответствующим методом в LocalDateTime. В этом случае смещение не участвует в вычислении и не изменится.

Все остальные экземпляры ChronoField выбросят UnsupportedTemporalTypeException.

Если поле не является ChronoField, то результат этого метода получается путём вызова TemporalField.adjustInto(Temporal, long) с this в качестве аргумента. В этом случае поле определяет, нужно ли и как корректировать момент.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withYear(int year)

Возвращает копию этой OffsetDateTime с изменённым годом.

Время и смещение не влияют на вычисление и останутся такими же в результате. Если день месяца некорректен для года, он будет изменён на последний допустимый день месяца.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withMonth(int month)

Возвращает копию этой OffsetDateTime с изменённым месяцем года.

Время и смещение не влияют на вычисление и останутся такими же в результате. Если день месяца некорректен для года, он будет изменён на последний допустимый день месяца.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withDayOfMonth(int dayOfMonth)

Возвращает копию этого OffsetDateTime с изменённым днём месяца.

Если полученное OffsetDateTime является недопустимым, выбрасывается исключение. Время и смещение не влияют на вычисление и будут такими же в результате.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withDayOfYear(int dayOfYear)

Возвращает копию этого OffsetDateTime с изменённым номером дня в году.

Время и смещение не влияют на вычисление и будут такими же в результате. Если полученное OffsetDateTime является недопустимым, выбрасывается исключение.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withHour(int hour)

Возвращает копию этого OffsetDateTime с изменённым часом.

Дата и смещение не влияют на вычисление и будут такими же в результате.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withMinute(int minute)

Возвращает копию этого OffsetDateTime с изменённой минутой.

Дата и смещение не влияют на вычисление и будут такими же в результате.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withSecond(int second)

Возвращает копию этого OffsetDateTime с изменённой секундой.

Дата и смещение не влияют на вычисление и будут такими же в результате.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime withNano(int nanoOfSecond)

Возвращает копию этого OffsetDateTime с изменённым наносекундами.

Дата и смещение не влияют на вычисление и будут такими же в результате.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime truncatedTo(TemporalUnit unit)

Возвращает копию этого OffsetDateTime с усечённым временем.

Усечение возвращает копию исходной даты и времени, с полями, меньшими, чем указанный единица, установленные в ноль. Например, усечение с единицей minutes установит поле секунды и наносекунд в ноль.

Единица должна иметь длительность, которая делится на длину стандартного дня без остатка. Это включает все предоставленные временные единицы в ChronoUnit и DAYS. Другие единицы выбрасывают исключение.

Смещение не влияет на вычисление и будет таким же в результате.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime plus(TemporalAmount amountToAdd)

Возвращает копию этой даты и времени с добавленным указанным значением.

Это возвращает OffsetDateTime, основанный на этом, с добавленным указанным значением. Значение обычно является Period или Duration, но может быть любого другого типа, реализующего интерфейс TemporalAmount.

Вычисление делегируется объекту значения вызовом TemporalAmount.addTo(Temporal). Реализация значения свободна реализовывать сложение любым способом, однако она обычно вызывает plus(long, TemporalUnit). Обратитесь к документации реализации значения, чтобы определить, можно ли ее успешно добавить.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime plus(long amountToAdd,
                           TemporalUnit unit)

Возвращает копию этой даты и времени с добавленным указанным значением.

Это возвращает OffsetDateTime, основанный на этом, с добавленным значением в терминах единицы. Если добавить значение невозможно, потому что единица не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Если поле является ChronoUnit, то сложение реализуется через LocalDateTime.plus(long, TemporalUnit). Смещение не является частью вычисления и останется неизменным в результате.

Если поле не является ChronoUnit, то результат этого метода получается вызовом TemporalUnit.addTo(Temporal, long) передав this в качестве аргумента. В этом случае единица определяет, нужно ли и как выполнить добавление.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime plusYears(long years)

Возвращает копию этого OffsetDateTime с добавлением указанного количества лет.

Этот метод добавляет указанное количество к полю лет в три шага:

1. Добавить введённые годы к полю год
2. Проверить, является ли полученная дата недопустимой
3. Если необходимо, скорректировать день месяца до последнего допустимого дня

Например, 2008-02-29 (високосный год) плюс один год приведет к недопустимой дате 2009-02-29 (невисокосный год). Вместо возвращения недопустимого результата, вместо этого выбирается последний допустимый день месяца, 2009-02-28.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime plusMonths(long months)

Возвращает копию этого OffsetDateTime с добавлением указанного количества месяцев.

Этот метод добавляет указанное количество к полю месяца в три шага:

1. Добавить введённые месяцы к полю месяц
2. Проверить, является ли полученная дата недопустимой
3. Если необходимо, скорректировать день месяца до последнего допустимого дня

Например, 2007-03-31 плюс один месяц приведет к недопустимой дате 2007-04-31. Вместо возвращения недопустимого результата, вместо этого выбирается последний допустимый день месяца, 2007-04-30.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime plusWeeks(long weeks)

Возвращает копию этого OffsetDateTime с добавлением указанного количества недель.

Этот метод добавляет указанное количество недель к полю дни, увеличивая поля месяц и год при необходимости, чтобы результат оставался корректным. Результат будет недопустимым только в случае превышения максимального/минимального года.

Например, 2008-12-31 плюс одна неделя приведет к 2009-01-07.

Этот экземпляр неизменяемый и не изменяется этим вызовом метода.

public OffsetDateTime plusDays(long days)

Возвращает копию этого OffsetDateTime с добавлением указанного числа дней.

Этот метод добавляет указанное количество к полю «дни», увеличивая поля «месяц» и «год» по мере необходимости, чтобы результат оставался допустимым. Результат недопустим только в том случае, если превышен максимальный/минимальный год.

Например, 31 декабря 2008 года плюс один день даст 1 января 2009 года.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime plusHours(long hours)

Возвращает копию этого OffsetDateTime с добавлением указанного числа часов.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime plusMinutes(long minutes)

Возвращает копию этого OffsetDateTime с добавлением указанного числа минут.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime plusSeconds(long seconds)

Возвращает копию этого OffsetDateTime с добавлением указанного числа секунд.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime plusNanos(long nanos)

Возвращает копию этого OffsetDateTime с добавлением указанного числа наносекунд.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minus(TemporalAmount amountToSubtract)

Возвращает копию этой даты и времени с вычитанием указанного количества.

Это возвращает OffsetDateTime, основанный на этом, с вычитанием указанного количества. Количество обычно является Period или Duration, но может быть любого другого типа, реализующего интерфейс TemporalAmount.

Вычисление делегируется объекту количества вызовом TemporalAmount.subtractFrom(Temporal). Реализация количества свободна реализовать вычитание любым способом, однако обычно она вызывает minus(long, TemporalUnit). Обратитесь к документации реализации количества, чтобы определить, можно ли её успешно вычесть.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minus(long amountToSubtract,
                            TemporalUnit unit)

Возвращает копию этой даты и времени с вычитанием указанного количества.

Это возвращает OffsetDateTime, основанный на этом, с вычитанием количества в терминах единицы. Если вычитание невозможно из-за того, что единица не поддерживается или по какой-либо другой причине, выбрасывается исключение.

Этот метод эквивалентен plus(long, TemporalUnit) с отрицательным количеством. См. этот метод для полного описания того, как работает сложение, и, следовательно, вычитание.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusYears(long years)

Возвращает копию этого OffsetDateTime с вычитанием указанного количества лет.

Этот метод вычитает указанное количество из поля «годы» в трех шагах:

1. Вычесть введённые годы из поля «год»
2. Проверить, является ли результирующая дата недопустимой
3. При необходимости скорректировать день месяца до последнего допустимого дня

Например, 29 февраля 2008 года (високосный год) минус один год даст недопустимую дату 29 февраля 2009 года (невисокосный год). Вместо возвращения недопустимого результата, вместо этого выбирается последний допустимый день месяца, 28 февраля 2009 года.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusMonths(long months)

Возвращает копию этого OffsetDateTime с вычитанием указанного количества месяцев.

Этот метод вычитает указанное количество из поля «месяцы» в трех шагах:

1. Вычесть введённые месяцы из поля «месяц»
2. Проверить, является ли результирующая дата недопустимой
3. При необходимости скорректировать день месяца до последнего допустимого дня

Например, 31 марта 2007 года минус один месяц даст недопустимую дату 31 апреля 2007 года. Вместо возвращения недопустимого результата, вместо этого выбирается последний допустимый день месяца, 30 апреля 2007 года.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusWeeks(long weeks)

Возвращает копию этого OffsetDateTime с вычитанием указанного количества недель.

Этот метод вычитает указанное количество недель из поля «дни», уменьшая поля «месяц» и «год» по мере необходимости, чтобы результат оставался допустимым. Результат недопустим только в том случае, если превышен максимальный/минимальный год.

Например, 31 декабря 2008 года минус одна неделя даст 7 января 2009 года.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusDays(long days)

Возвращает копию этого OffsetDateTime с вычитанием указанного числа дней.

Этот метод вычитает указанное количество из поля «дни», уменьшая поля «месяц» и «год» по мере необходимости, чтобы результат оставался допустимым. Результат недопустим только в том случае, если превышен максимальный/минимальный год.

Например, 31 декабря 2008 года минус один день даст 1 января 2009 года.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusHours(long hours)

Возвращает копию этого OffsetDateTime с вычитанием указанного числа часов.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusMinutes(long minutes)

Возвращает копию этого OffsetDateTime с вычитанием указанного числа минут.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusSeconds(long seconds)

Возвращает копию этого OffsetDateTime с вычитанием указанного числа секунд.

Этот экземпляр неизменяемый и не затрагивается этим вызовом метода.

public OffsetDateTime minusNanos(long nanos)

Возвращает копию этого OffsetDateTime с указанным количеством наносекунд, вычтенных из неё.

Этот экземпляр неизменяем и не затрагивается этим вызовом метода.

public <R> R query(TemporalQuery<R> query)

Запрашивает эту дату и время с использованием указанного запроса.

Этот запрос выполняет запрос к этой дате и времени с использованием указанного объекта стратегии запроса. Объект TemporalQuery определяет логику, используемую для получения результата. Прочитайте документацию запроса, чтобы понять, каким будет результат этого метода.

Результат этого метода получается путём вызова метода TemporalQuery.queryFrom(TemporalAccessor) для указанного запроса, передавая this в качестве аргумента.

public Temporal adjustInto(Temporal temporal)

Настраивает указанный временной объект так, чтобы он имел тот же часовой пояс, дату и время, что и этот объект.

Это возвращает временной объект того же наблюдаемого типа, что и входной, с изменённым часовым поясом, датой и временем, которые будут такими же, как у этого.

Настройка эквивалентна трём вызовам Temporal.with(TemporalField, long), передавая ChronoField.EPOCH_DAY, ChronoField.NANO_OF_DAY и ChronoField.OFFSET_SECONDS в качестве полей.

В большинстве случаев яснее использовать обратный порядок вызовов, используя Temporal.with(TemporalAdjuster):

// these two lines are equivalent, but the second approach is recommended
   temporal = thisOffsetDateTime.adjustInto(temporal);
   temporal = temporal.with(thisOffsetDateTime);

Этот экземпляр неизменяем и не затрагивается этим вызовом метода.

public long until(Temporal endExclusive,
                  TemporalUnit unit)

Вычисляет количество времени до другой даты и времени в терминах указанного измерения.

Это вычисляет количество времени между двумя объектами OffsetDateTime в терминах одного TemporalUnit. Начальная и конечная точки — это this и указанная дата и время. Результат будет отрицательным, если конец находится до начала. Например, количество дней между двумя датами и временем можно вычислить с использованием startDateTime.until(endDateTime, DAYS).

Temporal , переданное этому методу, преобразуется в OffsetDateTime с использованием from(TemporalAccessor). Если смещение отличается между двумя датами и временем, указанная конечная дата и время нормализуются так, чтобы иметь то же смещение, что и эта дата и время.

Вычисление возвращает целое число, представляющее количество полных единиц между двумя датами и временем. Например, количество месяцев между 2012-06-15T00:00Z и 2012-08-14T23:59Z будет только один месяц, так как до двух месяцев не хватает одной минуты.

Есть два эквивалентных способа использования этого метода. Первый - вызвать этот метод. Второй - использовать TemporalUnit.between(Temporal, Temporal):

// these two lines are equivalent
   amount = start.until(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 приведут к исключению.

Если единица не является ChronoUnit, то результат этого метода получается путём вызова TemporalUnit.between(Temporal, Temporal) , передавая this в качестве первого аргумента и преобразованный входной временной параметр в качестве второго аргумента.

Этот экземпляр неизменяем и не затрагивается этим вызовом метода.

public String format(DateTimeFormatter formatter)

Форматирует эту дату и время с использованием указанного форматера.

Эта дата и время будут переданы в форматер для создания строки.

public ZonedDateTime atZoneSameInstant(ZoneId zone)

Объединяет эту дату и время с часовым поясом, создавая ZonedDateTime, гарантируя, что результат имеет тот же момент времени.

Возвращает ZonedDateTime, сформированную из этой даты и времени и указанного часового пояса. Это преобразование игнорирует видимую локальную дату и время и использует лежащий в основе момент времени вместо этого. Это позволяет избежать проблем с разрывами или наложениями локальной временной линии. Результат может иметь различные значения для полей, таких как час, минута и даже день.

Для попытки сохранить значения полей используйте atZoneSimilarLocal(ZoneId). Для использования смещения в качестве идентификатора часового пояса используйте toZonedDateTime().

public ZonedDateTime atZoneSimilarLocal(ZoneId zone)

Объединяет эту дату и время с часовым поясом, создавая ZonedDateTime, пытаясь сохранить ту же локальную дату и время.

Возвращает ZonedDateTime, сформированную из этой даты и времени и указанного часового пояса. По возможности, результат будет иметь ту же локальную дату и время, что и этот объект.

Правила часового пояса, такие как летнее время, означают, что не каждое время на локальной временной линии существует. Если локальная дата и время находятся в разрыве или наложении в соответствии с правилами, используется решатель для определения результирующего локального времени и смещения. Этот метод использует ZonedDateTime.ofLocal(LocalDateTime, ZoneId, ZoneOffset) для сохранения смещения из этого экземпляра, если это возможно.

Более точный контроль над разрывами и наложениями доступен двумя способами. Если вам просто нужно использовать более позднее смещение при наложениях, вызовите ZonedDateTime.withLaterOffsetAtOverlap() сразу после этого метода.

Для создания объекта zoned date-time в тот же момент времени независимо от локальной временной линии используйте atZoneSameInstant(ZoneId). Для использования смещения в качестве идентификатора часового пояса используйте toZonedDateTime().

public OffsetTime toOffsetTime()

Преобразует эту дату и время в OffsetTime.

Возвращает время со смещением с тем же локальным временем и смещением.

public ZonedDateTime toZonedDateTime()

Преобразует эту дату и время в ZonedDateTime, используя смещение как идентификатор часового пояса.

Создаёт максимально простой ZonedDateTime с использованием смещения в качестве идентификатора часового пояса.

Для управления используемым часовым поясом см. atZoneSameInstant(ZoneId) и atZoneSimilarLocal(ZoneId).

public Instant toInstant()

Преобразует эту дату и время в Instant.

Возвращает Instant, представляющий ту же точку на временной шкале, что и эта дата и время.

public long toEpochSecond()

Преобразует эту дату и время в количество секунд с эпохи 1970-01-01T00:00:00Z.

Это позволяет преобразовать эту дату и время в значение поля epoch-seconds. Это предназначено в первую очередь для преобразований низкого уровня, а не для общего использования в приложениях.

public int compareTo(OffsetDateTime other)

Сравнивает данную дату и время с другой датой и временем.

Сравнение основано на мгновении времени, а затем на локальной дате и времени. Оно соответствует «совпадению», как определено в Comparable.

Например, порядок компаратора следующий:

1. 2008-12-03T10:30+01:00
2. 2008-12-03T11:00+01:00
3. 2008-12-03T12:00+02:00
4. 2008-12-03T11:30+01:00
5. 2008-12-03T12:00+01:00
6. 2008-12-03T12:30+01:00

Значения #2 и #3 представляют одно и то же мгновение на временной шкале. Когда два значения представляют одно и то же мгновение, сравнивается локальное время, чтобы отличить их. Этот шаг необходим для обеспечения согласованности порядка со equals().

public boolean isAfter(OffsetDateTime other)

Проверяет, является ли мгновение времени этой даты и времени после мгновения времени указанной даты и времени.

Этот метод отличается от сравнения в compareTo(java.time.OffsetDateTime) и equals(java.lang.Object) тем, что сравнивает только мгновение времени. Это эквивалентно использованию dateTime1.toInstant().isAfter(dateTime2.toInstant());.

public boolean isBefore(OffsetDateTime other)

Проверяет, является ли мгновение времени этой даты и времени до мгновения времени указанной даты и времени.

Этот метод отличается от сравнения в compareTo(java.time.OffsetDateTime) тем, что сравнивает только мгновение времени. Это эквивалентно использованию dateTime1.toInstant().isBefore(dateTime2.toInstant());.

public boolean isEqual(OffsetDateTime other)

Проверяет, равно ли мгновение времени этой даты и времени мгновению времени указанной даты и времени.

Этот метод отличается от сравнения в compareTo(java.time.OffsetDateTime) и equals(java.lang.Object) тем, что сравнивает только мгновение времени. Это эквивалентно использованию dateTime1.toInstant().equals(dateTime2.toInstant());.

public boolean equals(Object obj)

Проверяет, равна ли данная дата и время другой дате и времени.

Сравнение основано на локальной дате и времени и смещении. Для сравнения одинакового мгновения времени на временной шкале используйте isEqual(java.time.OffsetDateTime). Сравниваются только объекты типа OffsetDateTime, другие типы возвращают false.

public int hashCode()

public String toString()

Выводит эту дату и время как String, например, 2007-12-03T10:15:30+01:00.

Вывод будет одним из следующих форматов ISO-8601:

• uuuu-MM-dd'T'HH:mmXXXXX
• uuuu-MM-dd'T'HH:mm:ssXXXXX
• uuuu-MM-dd'T'HH:mm:ss.SSSXXXXX
• uuuu-MM-dd'T'HH:mm:ss.SSSSSSXXXXX
• uuuu-MM-dd'T'HH:mm:ss.SSSSSSSSSXXXXX

Используемый формат будет самым коротким, который выводит полное значение времени, где пропущенные части подразумеваются как нули.