tzf

快速根据GPS经纬度坐标查找时区

概览

扩展包名版本分类许可证语言
pg_tzf0.2.4GISMITRust
ID扩展名BinLibLoadCreateTrustReloc模式
1680tzf-
相关扩展postgis geoip pg_cron postgis_topology postgis_raster postgis_sfcgal postgis_tiger_geocoder address_standardizer

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY0.2.41817161514pg_tzf-
RPMPIGSTY0.2.41817161514pg_tzf_$v-
DEBPIGSTY0.2.41817161514postgresql-$v-tzf-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
d13.x86_64
d13.aarch64
u22.x86_64
u22.aarch64
PIGSTY 0.2.4
PIGSTY 0.2.4
PIGSTY 0.2.4
PIGSTY 0.2.4
PIGSTY 0.2.4
u24.x86_64
u24.aarch64
PIGSTY 0.2.4
PIGSTY 0.2.4
PIGSTY 0.2.4
PIGSTY 0.2.4
PIGSTY 0.2.4
u26.x86_64PIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISSPIGSTY MISS
u26.aarch64

构建

您可以使用 pig build 命令构建 pg_tzf 扩展的 RPM / DEB 包:

pig build pkg pg_tzf         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_tzf 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

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;

用法

来源:README, releases

tzf 是一个 PostgreSQL 扩展,用于根据经纬度坐标快速查找 timezone。pgext catalog 将 package pg_tzf 映射到 extension tzf,并记录版本 0.2.4,覆盖 PostgreSQL 14-18。

创建扩展

CREATE EXTENSION tzf;

上游项目按 PostgreSQL major version 提供一个构建产物。其 release page 现在在 v0.2.4 之后列出 v0.3.0;此 stub 仍让版本和 package 名与 db/extension.csv 对齐。

函数

坐标查询:

SELECT tzf_tzname(116.3883, 39.9289) AS timezone;

批量坐标查询:

SELECT unnest(
  tzf_tzname_batch(
    ARRAY[-74.0060, -118.2437, 139.6917],
    ARRAY[40.7128, 34.0522, 35.6895]
  )
) AS timezones;

Point 查询:

SELECT tzf_tzname_point(point(-74.0060, 40.7128)) AS timezone;

批量 point 查询:

SELECT unnest(
  tzf_tzname_batch_points(
    ARRAY[
      point(-74.0060, 40.7128),
      point(-118.2437, 34.0522),
      point(139.6917, 35.6895)
    ]
  )
) AS timezones;

说明

  • 上游 README 记录支持 PostgreSQL 14 到 18 builds。
  • 预构建 release tarballs 包含 tzf.sotzf.controltzf--<version>.sql
  • 当前 README 仍指向 sql/tzf.sql 中的完整 schema,并包含上面四个查询函数的 benchmark 数字。

最后修改 2026-05-18: routine extension update (ac43610)