Класс Instant

Минимальное поддерживаемое значение Instant, '-1000000000-01-01T00:00Z'. Может использоваться приложением как момент "далёкого прошлого".

На один год раньше минимального LocalDateTime. Это обеспечивает достаточные значения для обработки диапазона ZoneOffset, влияющих на момент помимо локального времени. Значение также выбрано таким образом, чтобы значение года помещалось в int.

Максимальное поддерживаемое значение Instant, '1000000000-12-31T23:59:59.999999999Z'. Может использоваться приложением как момент "далёкого будущего".

На один год позже максимального LocalDateTime. Это обеспечивает достаточные значения для обработки диапазона ZoneOffset, влияющих на момент помимо локального времени. Значение также выбрано таким образом, чтобы значение года помещалось в int.

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

Обращается к system UTC clock для получения текущего момента.

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

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

Обращается к указанным часам для получения текущего времени.

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

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

Поле наносекунд установлено в ноль.

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

Этот метод позволяет передавать произвольное количество наносекунд. Фабрика изменит значения секунды и наносекунд для обеспечения того, что сохранённые наносекунды находятся в диапазоне от 0 до 999 999 999. Например, следующее приведёт к точно такому же моменту времени:

Instant.ofEpochSecond(3, 1);
  Instant.ofEpochSecond(4, -999_999_999);
  Instant.ofEpochSecond(2, 1000_000_001);

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

Секунды и наносекунды извлекаются из указанных миллисекунд.

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

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

Преобразование извлекает поля INSTANT_SECONDS и NANO_OF_SECOND.

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

Получает экземпляр Instant из текстовой строки, такой как 2007-12-03T10:15:30.00Z.

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

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

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

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

• NANO_OF_SECOND
• MICRO_OF_SECOND
• MILLI_OF_SECOND
• INSTANT_SECONDS

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

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

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

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

• NANOS
• MICROS
• MILLIS
• SECONDS
• MINUTES
• HOURS
• HALF_DAYS
• DAYS

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

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

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

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

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

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

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

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

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

Возвращает значение указанного поля из текущего момента как long.

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

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

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

Возвращает количество секунд с эпохи Java 1970-01-01T00:00:00Z.

Счётчик эпохи в секундах — это просто возрастающая последовательность секунд, где секунда 0 — 1970-01-01T00:00:00Z. Часть наносекунд дня возвращается методом getNanosOfSecond.

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

Значение наносекунд секунды измеряет общее количество наносекунд с секунды, возвращённой методом getEpochSecond.

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

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

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

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

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

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

Если поле является ChronoField, то корректировка реализуется здесь. Поддерживаемые поля ведут себя следующим образом:

• NANO_OF_SECOND - Возвращает Instant с указанными наносекундами. Эпоха в секундах останется неизменной.
• MICRO_OF_SECOND - Возвращает Instant с наносекундами, заменёнными указанными микросекундами, умноженными на 1000. Эпоха в секундах останется неизменной.
• MILLI_OF_SECOND - Возвращает Instant с наносекундами, заменёнными указанными миллисекундами, умноженными на 1 000 000. Эпоха в секундах останется неизменной.
• INSTANT_SECONDS - Возвращает Instant с указанной эпохой в секундах. Наносекунды останутся неизменными.

Во всех случаях, если новое значение выходит за пределы допустимого диапазона значений для поля, будет выброшено DateTimeException.

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

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

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

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

Усечение момента времени возвращает копию оригинала с полями, меньшими, чем указанный интервал, установленные в ноль. Поля рассчитываются на основе использования смещения UTC, как показано в toString. Например, усечение с использованием интервала MINUTES округлится вниз до ближайшей минуты, установив секунды и наносекунды в ноль.

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

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

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

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

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

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

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

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

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

• NANOS - Возвращает Instant с добавлением указанного количества наносекунд. Это эквивалентно plusNanos(long).
• MICROS - Возвращает Instant с добавлением указанного количества микросекунд. Это эквивалентно plusNanos(long) со значением, умноженным на 1000.
• MILLIS - Возвращает Instant с добавлением указанного количества миллисекунд. Это эквивалентно plusNanos(long) со значением, умноженным на 1 000 000.
• SECONDS - Возвращает Instant с добавлением указанного количества секунд. Это эквивалентно plusSeconds(long).
• MINUTES - Возвращает Instant с добавлением указанного количества минут. Это эквивалентно plusSeconds(long) со значением, умноженным на 60.
• HOURS - Возвращает Instant с добавлением указанного количества часов. Это эквивалентно plusSeconds(long) со значением, умноженным на 3600.
• HALF_DAYS - Возвращает Instant с добавлением указанного количества полусуток. Это эквивалентно plusSeconds(long) со значением, умноженным на 43200 (12 часов).
• DAYS - Возвращает Instant с добавлением указанного количества дней. Это эквивалентно plusSeconds(long) со значением, умноженным на 86400 (24 часа).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Этот метод эквивалентен plus(long, TemporalUnit) со значением, умноженным на -1. Обратитесь к этому методу для полного описания того, как происходит добавление, а значит и вычитание.

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

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

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

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

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

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

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

Запрос этого момента времени с помощью указанного запроса.

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

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

Настраивает указанный временной объект на текущий момент времени.

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

Настройка эквивалентна дважды применению Temporal.with(TemporalField, long), передавая ChronoField.INSTANT_SECONDS и ChronoField.NANO_OF_SECOND в качестве полей.

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

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

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

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

Вычисляет временной интервал между двумя объектами Instant в терминах одной временной единицы TemporalUnit. Начальная и конечная точки — это this и указанный момент времени соответственно. Результат будет отрицательным, если конечная точка предшествует начальной. Результат вычисления — целое число, представляющее количество полных единиц между двумя моментами. Temporal , переданный в этот метод, преобразуется в Instant с использованием from(TemporalAccessor). Например, количество дней между двумя датами можно вычислить с помощью startInstant.until(endInstant, SECONDS).

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

// these two lines are equivalent
   amount = start.until(end, SECONDS);
   amount = SECONDS.between(start, end);

Вычисление реализовано в этом методе для ChronoUnit. Поддерживаются единицы NANOS, MICROS, MILLIS, SECONDS, MINUTES, HOURS, HALF_DAYS и DAYS. Другие значения ChronoUnit будут вызывать исключение.

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

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

Объединяет этот момент времени со смещением, чтобы создать OffsetDateTime.

Возвращает OffsetDateTime , образованный из этого момента времени со смещением относительно UTC/Гринвича. Если момент времени слишком большой, чтобы поместиться в дату и время со смещением, будет выброшено исключение.

Этот метод эквивалентен OffsetDateTime.ofInstant(this, offset).

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

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

Этот метод эквивалентен ZonedDateTime.ofInstant(this, zone).

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

Если этот момент времени представляет точку на временной шкале, слишком отстоящую в будущем или прошлом, чтобы уместиться в long миллисекунд, выбрасывается исключение.

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

Сравнивает этот момент времени с указанным.

Сравнение основано на позиции моментов времени на временной шкале. Оно "согласуется с методом equals", как определено в Comparable.

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

Сравнение основано на позиции моментов времени на временной шкале.

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

Сравнение основано на позиции моментов времени на временной шкале.

Проверяет, равен ли этот момент времени указанному.

Сравнение основано на позиции моментов времени на временной шкале.

Строковое представление этого момента времени в формате ISO-8601.

Использованный формат такой же, как у DateTimeFormatter.ISO_INSTANT.