Константа ISO_INSTANT

Константа ISO_INSTANT класса DateTimeFormatter предоставляет предопределенный форматтер для работы с моментами времени в формате ISO-8601. Она используется для преобразования объектов Instant в строковое представление и обратно. Формат включает дату, время и смещение в формате ГГГГ-ММ-ДДTЧЧ:мм:ссZ.

Импорт

kotlinimport java.time.format.DateTimeFormatter
import java.time.Instant

Синтаксис

kotlinDateTimeFormatter.ISO_INSTANT

Пример

Отформатируем объект Instant в строку с помощью ISO_INSTANT:

kotlinval instant = Instant.now()
val formatter = DateTimeFormatter.ISO_INSTANT
val formatted = formatter.format(instant)
println(formatted)

Результат выполнения кода:

kotlinString "2025-09-10T12:34:56.789Z"

Пример

Распарсим строку в формате ISO-8601 в объект Instant:

kotlinval dateStr = "2025-12-31T23:59:59.999Z"
val formatter = DateTimeFormatter.ISO_INSTANT
val instant = Instant.from(formatter.parse(dateStr))
println(instant)

Результат выполнения кода:

kotlinInstant 2025-12-31T23:59:59.999Z

Пример

Использование с parse для прямого преобразования:

kotlinval dateStr = "2025-06-15T12:30:45.123Z"
val instant = Instant.parse(dateStr)
println(instant)

Результат выполнения кода:

kotlinInstant 2025-06-15T12:30:45.123Z

Смотрите также

  • класс Instant,
    который представляет момент времени на временной шкале
  • константу ISO_LOCAL_DATE_TIME,
    которая форматирует локальную дату и время
  • константу ISO_ZONED_DATE_TIME,
    которая форматирует дату и время с часовым поясом
  • метод ofPattern,
    который создает кастомный форматтер