Функция getStandardOffset

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

Импорт

kotlinimport java.time.Instant
import java.time.ZoneId
import java.time.zone.ZoneRules

Синтаксис

kotlinfun getStandardOffset(instant: Instant): ZoneOffset

Пример

Получим стандартное смещение для часового пояса "Europe/Moscow" на конкретный момент времени:

kotlinval zoneId = ZoneId.of("Europe/Moscow")
val rules = zoneId.rules
val instant = Instant.parse("2025-06-15T12:00:00Z")
val standardOffset = rules.getStandardOffset(instant)

println("Standard offset: $standardOffset")

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

kotlinString "Standard offset: +03:00"

Пример

Сравним стандартное смещение для разных моментов времени в часовом поясе "America/New_York":

kotlinval zoneId = ZoneId.of("America/New_York")
val rules = zoneId.rules

val winterInstant = Instant.parse("2025-01-15T12:00:00Z")
val summerInstant = Instant.parse("2025-06-15T12:00:00Z")

val winterOffset = rules.getStandardOffset(winterInstant)
val summerOffset = rules.getStandardOffset(summerInstant)

println("Winter standard offset: $winterOffset")
println("Summer standard offset: $summerOffset")

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

kotlinString "Winter standard offset: -05:00"
String "Summer standard offset: -05:00"

Пример

Получим стандартное смещение для UTC часового пояса:

kotlinval zoneId = ZoneId.of("UTC")
val rules = zoneId.rules
val instant = Instant.now()
val standardOffset = rules.getStandardOffset(instant)

println("UTC standard offset: $standardOffset")

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

kotlinString "UTC standard offset: Z"

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