Класс OffsetDateTime

public static final OffsetDateTime MIN

Минимальное поддерживаемое OffsetDateTime, '-999999999-01-01T00:00:00+18:00'. Это локальные дата и время полуночи в начале минимальной даты при максимальном смещении (большие смещения соответствуют более раннему времени на временной шкале). Объединяет LocalDateTime.MIN и ZoneOffset.MAX. Приложение может использовать это значение как дату и время «далёкого прошлого».

public static final OffsetDateTime MAX

Максимальное поддерживаемое OffsetDateTime, '+999999999-12-31T23:59:59.999999999-18:00'. Это локальные дата и время непосредственно перед полуночью в конце максимальной даты при минимальном смещении (большие отрицательные смещения соответствуют более позднему времени на временной шкале). Объединяет LocalDateTime.MAX и ZoneOffset.MIN. Приложение может использовать это значение как дату и время «далёкого будущего».

public static Comparator<OffsetDateTime> timeLineOrder()

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

Этот метод отличается от сравнения в compareTo(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)

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

Проверяет, можно ли получить значение указанного поля из этих даты и времени. Если это не так, вызовы методов 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)

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

Проверяет, можно ли прибавить указанную единицу к этим дате и времени или вычесть её из них. Если это не так, вызовы методов 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, поэтому выбрасывается UnsupportedTemporalTypeException. Для всех остальных экземпляров 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(ZoneOffset).

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

public OffsetDateTime withOffsetSameInstant(ZoneOffset offset)

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

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

Чтобы изменить смещение, не корректируя местное время, используйте withOffsetSameLocal(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 с прибавленным указанным количеством дней.

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

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

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

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. При необходимости скорректировать день месяца до последнего допустимого дня

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

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

public OffsetDateTime minusMonths(long months)

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

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

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

Например, вычитание одного месяца из даты 2007-03-31 дало бы недопустимую дату 2007-02-31. Вместо возврата недопустимого результата выбирается последний допустимый день месяца — 2007-02-28.

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

public OffsetDateTime minusWeeks(long weeks)

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

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

Например, вычитание одной недели из даты 2009-01-07 даст 2008-12-31.

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

public OffsetDateTime minusDays(long days)

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

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

Например, вычитание одного дня из даты 2009-01-01 даст 2008-12-31.

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

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() сразу после этого метода.

Чтобы создать дату и время с часовым поясом, обозначающие тот же момент времени независимо от местной временной шкалы, используйте 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)

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

Сравнение выполняется сначала по моменту времени, а затем по местным дате и времени. Оно «согласовано с equals» в соответствии с определением 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(OffsetDateTime) и equals(Object) тем, что сравнивает только моменты времени. Это эквивалентно использованию dateTime1.toInstant().isAfter(dateTime2.toInstant());.

public boolean isBefore(OffsetDateTime other)

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

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

public boolean isEqual(OffsetDateTime other)

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

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

public boolean equals(Object obj)

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

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

public int hashCode()

Хеш-код этой даты и времени.

public String toString()

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

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

• 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

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