普贤教程 › 包参考

tzmini 包

时区最小集（常见都市偏移 + DST 规则）

项	值
包名	`tzmini`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`tzmini.px`
分类	`时间与日历`
文件数 / 行数	`1 / 189`

安装与引入

bash

pxpkg init          # 首次
pxpkg add tzmini@0.2.0
pxpkg install

import tzmini

所属分类教程：时间与日历

公开接口

函数	参数
`tz_zones`
`tz_utc_offset`	`zone`
`tz_offset`	`zone, utc_sec`
`tz_convert`	`zone, utc_sec`
`tz_format`	`zone, utc_sec, fmt`

其余 13 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`tz_days_from_civil`	`y, m, d`
`tz_is_leap`	`y`
`tz_days_in_month`	`y, m`
`tz_weekday`	`y, m, d`
`tz_nth_wd`	`y, m, wd, n`
`tz_rule_sec`	`y, m, d`
`tz_table`
`tz_dst_active`	`rule, y, sec`
`tz_civil`	`sec`
`tz_zone_offset`	`zone, y, sec`
`tz_zone_names`
`tz_convert_utc_to_zone`	`zone, y, sec`
`tz_convert_zone_to_utc`	`zone, y, sec`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/tzmini —— 时区最小集（常见都市偏移 + DST 规则）
------------------------------------------------------------
纯函数库（无 IO、无状态、自含公历算法），编译（px build）与解释（px run）双模式一致。
对应缺口表「时区数据库/IANA tz」的最小可实现面：
tz_zones()                       → ["UTC", "Asia/Shanghai", ...]（18 个常见都市）
tz_offset(zone, utc_sec)         → Ok(偏移分钟) | Err（DST 自动按规则判定）
tz_convert(zone, utc_sec)        → Ok({local_sec, offset_min}) | Err
tz_format(zone, utc_sec, fmt)    → Ok(本地时间字符串) | Err（strftime 布局）
tz_utc_offset(zone)              → Ok(标准偏移分钟) | Err
DST 规则三类（缩写）：
none 固定偏移；eu 最后周日 3月→最后周日 10月（+1h，欧洲）；
us 第2周日 3月→第1周日 11月（+1h）；au 第1周日 10月→第1周日 4月（+1h，南半球跨年）
日期算法自含（Hinnant civil 双向），仅公历正数域。
============================================================
---- 公历算法 ----