结构
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
创建一个对应于 identifier
的 GTimeZone
。如果无法解析或加载 identifier
,将返回 NULL
。
since: 2.68
实例方法
g_time_zone_adjust_time
在 tz
内查找一个与给定的 time_
对应且可能调整 time_
以适合一个区间的区间。time_
的含义取决于 type
。
since: 2.26
g_time_zone_get_identifier
获取此 GTimeZone
的标识符,如传递给 g_time_zone_new() 的那样。如果在构建时传递的标识符未被识别,则会返回 UTC
。如果标识符为 NULL
,则会返回构建时本地时区的标识符。
since: 2.58