FixedOffset

A time zone defined by a fixed offset from UTC.

In general, region-based time zones are preferred, but there are situations where only a fixed offset may be available.

class FixedOffset : TimeZone

Parameters

offset

a valid UTC offset

Functions

compareTo
Link copied to clipboard
common
open operator override fun compareTo(other: TimeZone): Int
displayName
Link copied to clipboard
common

A textual representation of this time zone, suitable for display purposes. The localized name will be returned, if available for the locale in the specified style. If not, the id will be returned instead.

The result depends on the configured TimeZoneTextProvider and may differ between platforms.

Example output for the "America/New_York" ID and "en-US" locale:

  • Standard: "Eastern Standard Time"

  • Short standard: "EST"

  • Daylight Saving: "Eastern Daylight Time"

  • Short daylight saving: "EDT"

  • Generic: "Eastern Time"

  • Short generic: "ET"

override fun displayName(style: TimeZoneTextStyle, locale: Locale): String
equals
Link copied to clipboard
common
open operator override fun equals(other: Any?): Boolean
hashCode
Link copied to clipboard
common
open override fun hashCode(): Int
localizedName
Link copied to clipboard
common

The localized name of this time zone, if available for the locale in the specified style. The result depends on the configured TimeZoneTextProvider and may differ between platforms.

Example output for the "America/New_York" ID and "en-US" locale:

  • Standard: "Eastern Standard Time"

  • Short standard: "EST"

  • Daylight Saving: "Eastern Daylight Time"

  • Short daylight saving: "EDT"

  • Generic: "Eastern Time"

  • Short generic: "ET"

override fun localizedName(style: TimeZoneTextStyle, locale: Locale): String?
normalized
Link copied to clipboard
common

Returns a normalized time zone, converting any zone with a fixed offset to use a consistent identifier.

open override fun normalized(): TimeZone.FixedOffset
toString
Link copied to clipboard
common

Returns the id of this time zone.

open override fun toString(): String
validate
Link copied to clipboard
common

Checks if this time zone is valid and throws an exception if it isn't.

override fun validate()
validated
Link copied to clipboard
common

Ensures that this time zone is valid, throwing an exception if it isn't.

override fun validated(): TimeZone

Properties

id
Link copied to clipboard
common

An ID that uniquely identifies the time zone.

open override val id: String
isValid
Link copied to clipboard
common

Checks if this is a valid time zone according to the current time zone rules provider.

open override val isValid: Boolean
offset
Link copied to clipboard
common

a valid UTC offset

val offset: UtcOffset
rules
Link copied to clipboard
common

The rules associated with this time zone.

open override val rules: TimeZoneRules