TimeZone

class TimeZone(pointer: <Error class: unknown class><<Error class: unknown class>>) : Record

A GTimeZone represents a time zone, at no particular point in time.

The GTimeZone struct is refcounted and immutable.

Each time zone has an identifier (for example, ‘Europe/London’) which is platform dependent. See ctor@GLib.TimeZone.new for information on the identifier formats. The identifier of a time zone can be retrieved using method@GLib.TimeZone.get_identifier.

A time zone contains a number of intervals. Each interval has an abbreviation to describe it (for example, ‘PDT’), an offset to UTC and a flag indicating if the daylight savings time is in effect during that interval. A time zone always has at least one interval — interval 0. Note that interval abbreviations are not the same as time zone identifiers (apart from ‘UTC’), and cannot be passed to ctor@GLib.TimeZone.new.

Every UTC time is contained within exactly one interval, but a given local time may be contained within zero, one or two intervals (due to incontinuities associated with daylight savings time).

An interval may refer to a specific period of time (eg: the duration of daylight savings time during 2010) or it may refer to many periods of time that share the same properties (eg: all periods of daylight savings time). It is also possible (usually for political reasons) that some properties (like the abbreviation) change between intervals without other properties changing.

Skipped during bindings generation

  • method adjust_time: In/Out parameter is not supported

Since

2.26

Constructors

Link copied to clipboard
constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Link copied to clipboard
object Companion : RecordCompanion<TimeZone, <Error class: unknown class>>

Properties

Link copied to clipboard
val glibTimeZonePointer: <Error class: unknown class><<Error class: unknown class>>

Functions

Link copied to clipboard
fun findInterval(type: TimeType, time: Long): Int

Finds an interval within @tz that corresponds to the given @time_. The meaning of @time_ depends on @type.

Link copied to clipboard
fun getAbbreviation(interval: Int): String

Determines the time zone abbreviation to be used during a particular

Link copied to clipboard

Get the identifier of this #GTimeZone, as passed to g_time_zone_new(). If the identifier passed at construction time was not recognised, UTC will be returned. If it was null, the identifier of the local timezone at construction time will be returned.

Link copied to clipboard
fun getOffset(interval: Int): Int

Determines the offset to UTC in effect during a particular @interval of time in the time zone @tz.

Link copied to clipboard
fun isDst(interval: Int): Boolean

Determines if daylight savings time is in effect during a particular

Link copied to clipboard
fun ref(): TimeZone

Increases the reference count on @tz.

Link copied to clipboard
fun unref()

Decreases the reference count on @tz.