Ответ
java.time.Instant — это класс из API Date and Time (Java 8+), представляющий точку на временной шкале. Он моделирует единый момент времени (timestamp) в UTC с наносекундной точностью.
Ключевые характеристики:
- Неизменяем (immutable) и потокобезопасен.
- Хранит количество секунд и наносекунд с эпохи Unix (1970-01-01T00:00:00Z).
- Основная цель — машинное время для логирования, замеров длительности и работы с системами.
Создание и использование:
// Текущий момент
Instant now = Instant.now();
System.out.println(now); // 2024-01-15T10:30:00.123456789Z
// Из эпохальных секунд и миллисекунд
Instant fromEpochSecond = Instant.ofEpochSecond(1_000_000);
Instant fromEpochMilli = Instant.ofEpochMilli(1_000_000_000L);
// Конвертация
long epochSeconds = now.getEpochSecond();
int nano = now.getNano();
// Арифметика
Instant later = now.plusSeconds(60);
Instant earlier = now.minusMillis(100);
// Сравнение
boolean isAfter = now.isAfter(earlier); // true
Основное применение:
- Запись временных меток событий.
- Измерение длительности операций (вместе с
Duration). - Конвертация в
java.util.Date(Date.from(instant)) для работы со старым кодом.