Linux 时区设置函数 tzset()【man 3 tzset】

news2025/1/18 2:09:24

1. NAME（名）

tzset, tzname, timezone, daylight - 初始化时间转换信息

2. SYNOPSIS（概要）

#include <time.h>

void tzset(void);

extern char *tzname[2];
extern long timezone;
extern int daylight;

glibc的功能测试宏要求（请参阅feature_test_macros(7)):

tzset(): _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE
tzname: _POSIX_C_SOURCE >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE
timezone: _SVID_SOURCE || _XOPEN_SOURCE
daylight: _SVID_SOURCE || _XOPEN_SOURCE

3. DESCRIPTION（函数描述）

tzset()从TZ环境变量中取出相应字段初始化全局变量tzname。tzset()会被时区相关的时间转换函数自动调用。在类System-V系统中，tzset()还将设置全局变量timezone（UTC以西的秒数）和daylight（如果该时区没有任何夏令时规则，则设置为0；如果存在夏令时规则，则设置为非0。）

如果未设置TZ环境变量，则使用系统时区。通过将tzfile(5)格式的文件复制或链接到/etc/localtime来配置系统时区。这些文件的时区数据库可能位于系统时区目录中（请参阅下面的FILES小节）。如果TZ变量确实出现在环境中，但其值为空，或者其值无法使用下面指定的任何格式进行解析，则使用协调世界时(UTC)，即UTC+0。

环境变量TZ的值有两种格式。第一种格式使用直接表示时区的字符串：

std offset[dst[offset][,start[/time],end[/time]]]

① 要注意上述格式中没有空格，std和其后offset之间的空格只是为了方便读者阅读而被鄙人故意加上的。
② std字符串指定时区的缩写，并且必须是三个或三个以上的字母字符，可随意起名。当使用尖括号括住std时，除字母外，字符集将扩展为包含加号（+）、减号（-）和数字。
③ offset，指定本地时间相对UTC+0的偏移。如果当地时区位于本初子午线的西面，则偏移量为正，如果位于东面，则偏移为负。小时必须介于0 - 24之间，分钟和秒必须介于00 - 59之间：[+|-]hh[:mm[:ss]]。
④ dst[offset]指定夏令时时区名称和偏移量，格式和std offset无异。如果dst存在而offset缺省，则会默认比标准时间快1小时。
⑤ start字段指定夏令时生效日期，end字段指定恢复到标准时间的日期。这些字段可能具有以下格式：

Jn：J为指示符，n的取1 - 365的儒略日（Julian day），不考虑闰年（Leap year），闰日（Leap day，即2月29日）不计算在内。2月28日是一年中的第59天，3月1日总是一年内的第60天，这种格式无法表示2月29日。
n：n取0 - 365的儒略日，2月29日会在闰年计数。全网发问：“好兄弟，请教个问题，n表示0 - 365的儒略日时，闰年的2月28 n=? 非闰年的2月28 n=?”
2024.06.18 验证如下：

Mm.w.d：M为指示符，m月（1<=m<=12）第w周（1<=w<=5）的第d天（0<=d<=6）。d=0是周日，d=1是周一，d=6是周六。

⑥ /time字段指定当前时间对夏时制的生效或结束时间。“/”是日期和时间的分隔指示符，time格式为/hh:mm:ss。如果缺省，则默认值为02:00:00，凌晨2点整。

举个例子就明白了：
TZ="NZST-12:00:00NZDT-13:00:00,M10.1.0/03:00:00,M3.3.0/03:00:00"

NZST 表示新西兰标准时间。
-12:00:00 表示比UTC早12小时。
NZDT 表示新西兰夏时制时间。
-13:00:00 表示夏时制时间比UTC早13小时（即比标准时间快1小时）。
M10.1.0/03:00:00 表示夏时制从10月第1个星期日凌晨3点开始。（不奇怪，新西兰是南半球国家）
M3.3.0/03:00:00 表示夏时制到3月第三个星期日凌晨3点结束。

第二种设置环境变量TZ的格式：从指定文件中读取时区信息

:[filespec]

指定获取时区的文件，A：filespec指向了一个tzfile(5)格式的文件。如果省略了filespec或filespec无法解析则使用协调世界时（UTC+0）。B：如果filespec路径不是以’/’开头（绝对路径），则在系统时区目录（/usr/share/zoneinfo/）下查找对应文件。如果冒号被省略，则A、B都将被系统尝试。
举个例子就明白了：
TZ=":Pacific/Auckland"（太平洋/奥克兰，新西兰第一大城市，风帆之都）

指定在系统时区数据库目录（/usr/share/zoneinfo/）下查找Pacific/Auckland文件，作为获取时区信息文件。

4. ENVIRONMENT （相关环境变量）

TZ：如果设置了此变量，则其值优先于系统配置的时区（即/etc/localtime）。
TZDIR：如果设置了此变量，则其值优先于系统配置的时区数据库目录路径（即/usr/share/zoneinfo/）。

5. FILES（文件）

/etc/localtime：系统时区文件，一般链接到某个具体的tzfile(5)格式时区文件。符合特定语法的文本文件经zic编译生成tzfile(5)格式的时区信息文件。
/usr/share/zoneinfo/：系统时区数据库目录。
/usr/share/zoneinfo/posixrules：当TZ变量包含DST时区，但未规定开始和结束时间时，则使用该文件规则规定DST的开始和结束时间。

以上是当前的标准文件路径，但是在编译glibc（tzfile.h）时可以配置它们。