结构

GLibTimeZone

since: 2.26

说明 [src]

struct GTimeZone {
  /* No available fields */
}

GTimeZone 表示时区,处于时间中的具体某一点。

GTimeZone 结构是引用计数的,并且不可变。

每个时区都有一个标识符(例如“Europe/London”),该标识符取决于平台。有关标识符格式的信息,请参阅 g_time_zone_new()。可以用 g_time_zone_get_identifier() 检索时区的标识符。

时区包含多个区间。每个区间都有一个缩写来描述它(例如,“PDT”),以及到 UTC 的偏移量,以及一个标志,指示该区间内是否实施夏令时。时区始终至少有一个区间——第 0 个区间。请注意,区间缩写与时区标识符不同(“UTC”除外),并且不能传递给 g_time_zone_new()

每个 UTC 时间都包含在正好一个区间内,但给定的本地时间可能包含在 0、1、或 2 个区间内(由于与夏令时关联的不连续性)。

一个区间可能指特定时间段(例如:2010 年夏令时的持续时间),或者可能指具有相同属性的多个时间段(例如:所有夏令时)。也可能(通常出于政治原因)一些属性(如缩写)在没有其他属性的情况下在区间之间发生改变。

可用性:2.26

构造函数

g_time_zone_new

如果无法解析或加载 identifier,则返回 UTC 时区的 g_time_zone_new_identifier() 版本。

已弃用:2.68 since: 2.26

g_time_zone_new_identifier

创建一个对应于 identifierGTimeZone。如果无法解析或加载 identifier,将返回 NULL

since: 2.68

g_time_zone_new_local

创建一个对应于本地时间的 GTimeZone。在调用此函数的不同时间,本地时区可能会发生变化;例如,如果系统管理员更改了它。

since: 2.26

g_time_zone_new_offset

创建一个对应于给定从 UTC 的定值偏移量的 GTimeZone,以秒为单位。

since: 2.58

g_time_zone_new_utc

创建对应于 UTCGTimeZone

since: 2.26

实例方法

g_time_zone_adjust_time

tz 内查找一个与给定的 time_ 对应且可能调整 time_ 以适合一个区间的区间。time_ 的含义取决于 type

since: 2.26

g_time_zone_find_interval

tz 中查找与给定的 time_ 相对应的区间。time_ 的含义取决于 type

since: 2.26

g_time_zone_get_abbreviation

在时区 tz 的特定时间 interval 中确定要使用的时区缩写。

since: 2.26

g_time_zone_get_identifier

获取此 GTimeZone 的标识符,如传递给 g_time_zone_new() 的那样。如果在构建时传递的标识符未被识别,则会返回 UTC。如果标识符为 NULL,则会返回构建时本地时区的标识符。

since: 2.58

g_time_zone_get_offset

在时区 tz 的特定时间 interval 中确定针对 UTC 的偏移量。

since: 2.26

g_time_zone_is_dst

判断在时区 tz 的特定时间 interval 中,夏令时是否生效。

since: 2.26

g_time_zone_ref

增加对 tz 的引用计数。

since: 2.26

g_time_zone_unref

减少对 tz 的引用计数。

since: 2.26