tzf
快速根据GPS经纬度坐标查找时区
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_tzf | 0.2.3 | GIS | MIT | Rust |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 1680 | tzf | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | postgis geoip pg_cron postgis_topology postgis_raster postgis_sfcgal postgis_tiger_geocoder address_standardizer |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 0.2.3 | 1817161514 | pg_tzf | - |
| RPM | PIGSTY | 0.2.3 | 1817161514 | pg_tzf_$v | - |
| DEB | PIGSTY | 0.2.3 | 1817161514 | postgresql-$v-tzf | - |
构建
您可以使用 pig build 命令构建 pg_tzf 扩展的 RPM / DEB 包：
pig build pkg pg_tzf # 构建 RPM / DEB 包
安装
您可以直接安装 pg_tzf 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_tzf; # 当前活跃 PG 版本安装
pig ext install -y pg_tzf -v 18 # PG 18
pig ext install -y pg_tzf -v 17 # PG 17
pig ext install -y pg_tzf -v 16 # PG 16
pig ext install -y pg_tzf -v 15 # PG 15
pig ext install -y pg_tzf -v 14 # PG 14
dnf install -y pg_tzf_18 # PG 18
dnf install -y pg_tzf_17 # PG 17
dnf install -y pg_tzf_16 # PG 16
dnf install -y pg_tzf_15 # PG 15
dnf install -y pg_tzf_14 # PG 14
apt install -y postgresql-18-tzf # PG 18
apt install -y postgresql-17-tzf # PG 17
apt install -y postgresql-16-tzf # PG 16
apt install -y postgresql-15-tzf # PG 15
apt install -y postgresql-14-tzf # PG 14
创建扩展：
CREATE EXTENSION tzf;
用法
根据坐标查找时区名称。基于 tzf-rs 构建，使用来自 timezone-boundary-builder 的时区边界数据。
CREATE EXTENSION tzf;
函数
根据坐标（经度、纬度）查找时区：
SELECT tzf_tzname(116.3883, 39.9289) AS timezone;
-- Asia/Shanghai
批量查找坐标的时区：
SELECT unnest(
tzf_tzname_batch(
ARRAY[-74.0060, -118.2437, 139.6917],
ARRAY[40.7128, 34.0522, 35.6895]
)
) AS timezones;
-- America/New_York
-- America/Los_Angeles
-- Asia/Tokyo
根据点查找时区：
SELECT tzf_tzname_point(point(-74.0060, 40.7128)) AS timezone;
-- America/New_York
批量查找点的时区：
SELECT unnest(
tzf_tzname_batch_points(
ARRAY[
point(-74.0060, 40.7128),
point(-118.2437, 34.0522),
point(139.6917, 35.6895)
]
)
) AS timezones;
-- America/New_York
-- America/Los_Angeles
-- Asia/Tokyo
性能
| 函数 | TPS | 备注 |
|---|---|---|
tzf_tzname | ~17,700 | 单坐标查找 |
tzf_tzname_point | ~17,600 | 单点查找 |
tzf_tzname_batch | ~51 | 1000 个一批 ≈ ~51,000 TPS |
tzf_tzname_batch_points | ~32 | 1000 个一批 ≈ ~32,000 TPS |