Класс Instant

public final class Instant
extends Object
implements Temporal, TemporalAdjuster, Comparable<Instant>, Serializable

Мгновенная точка на временной шкале.

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

Диапазон значений момента времени требует хранения числа, большего, чем long. Для этого класс хранит значение long, представляющее эпохальные секунды, и int, представляющее наносекунды, которое всегда будет находиться в диапазоне от 0 до 999 999 999. Эпохальные секунды измеряются с момента стандартной эпохи Java 1970-01-01T00:00:00Z, где моменты времени после эпохи имеют положительные значения, а более ранние моменты имеют отрицательные значения. Для обеих частей — эпохальных секунд и наносекунд — большее значение всегда соответствует более позднему моменту времени на временной шкале по сравнению с меньшим значением.

Временная шкала

Длина солнечного дня является стандартным способом измерения времени людьми. Традиционно она делилась на 24 часа по 60 минут по 60 секунд, образуя день длиной в 86400 секунд.

Современное времяисчисление основано на атомных часах, которые точно определяют СИ-секунду относительно переходов атома цезия. Длина СИ-секунды была определена как очень близкая к 86400-й доле дня.

К сожалению, из-за вращения Земли длина дня варьируется. Кроме того, со временем средняя длина дня увеличивается по мере замедления вращения Земли. В результате длина солнечного дня в 2012 году немного больше 86400 СИ-секунд. Фактическая длина любого данного дня и величина замедления вращения Земли непредсказуемы и могут быть определены только путем измерения. Временная шкала UT1 фиксирует точную длину дня, но она доступна лишь некоторое время после завершения дня.

Временная шкала UTC — это стандартный подход к объединению всех дополнительных долей секунды от UT1 в целые секунды, известные как лишние секунды. Лишняя секунда может быть добавлена или удалена в зависимости от изменений вращения Земли. Таким образом, UTC позволяет дню иметь 86399 СИ-секунд или 86401 СИ-секунд, когда это необходимо, чтобы день оставался синхронизированным с Солнцем.

Современная временная шкала UTC была введена в 1972 году, введя понятие целых лишних секунд. В период с 1958 по 1972 год определение UTC было сложным, с незначительными прыжками в долях секунды и изменениями длины условной секунды. По состоянию на 2012 год ведутся обсуждения по изменению определения UTC снова, с возможностью удаления лишних секунд или внесения других изменений.

Учитывая сложность точного измерения времени, описанную выше, данный API Java определяет собственную временную шкалу — временную шкалу Java.

Временная шкала Java делит каждый календарный день ровно на 86400 подразделений, называемых секундами. Эти секунды могут отличаться от СИ-секунды. Она тесно связана с фактической международной гражданской шкалой времени, определение которой время от времени меняется.

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

• временная шкала Java должна тесно соответствовать основной международной гражданской временной шкале;
• временная шкала Java должна точно соответствовать международной гражданской временной шкале в полдень каждый день;
• временная шкала Java должна иметь точно определённую связь с международной гражданской временной шкалой.

В настоящее время, по состоянию на 2013 год, в временной шкале Java есть два фрагмента.

Для фрагмента с 1972-11-03 (точное граничное значение обсуждается ниже) и до дальнейшего уведомления, согласованная международная временная шкала — UTC (с дополнительными секундами). В этом фрагменте временная шкала Java идентична UTC-SLS. Это идентично UTC в дни, не имеющие дополнительной секунды. В дни, когда дополнительная секунда есть, дополнительная секунда равномерно распределяется по последним 1000 секундам дня, сохраняя видимость ровно 86400 секунд в день.

Для фрагмента до 1972-11-03, простираясь произвольно далеко назад, согласованная международная временная шкала определяется как UT1, применённый пролептически, что эквивалентно (среднему) солнечному времени на нулевом меридиане (Гринвич). В этом фрагменте временная шкала Java идентична согласованной международной временной шкале. Точная граница между двумя фрагментами — момент, когда UT1 = UTC между 1972-11-03T00:00 и 1972-11-04T12:00.

Реализации временной шкалы Java, использующие API JSR-310, не обязаны предоставлять часы с точностью до долей секунды или с монотонным или плавным продвижением. Поэтому реализации не обязаны фактически выполнять плавное изменение UTC-SLS или каким-либо другим образом учитывать дополнительные секунды. Однако JSR-310 требует, чтобы реализации должны были задокументировать подход, который они используют при определении часов, представляющих текущий момент. Подробности о доступных часах см. в Clock.

Временная шкала Java используется для всех классов даты и времени. Это включает Instant, LocalDate, LocalTime, OffsetDateTime, ZonedDateTime и Duration.

Это классовый тип; использование операций, чувствительных к идентификатору (включая равенство ссылок (==), код хэша по идентификатору или синхронизацию) на экземплярах Instant может привести к непредсказуемым результатам и должно быть избегаемо. Для сравнений необходимо использовать метод equals.