extract函数用于从时间类型值中提取指定字段并返回浮点数,需用全大写字段名;时区处理需谨慎,timestamptz按服务器时区计算;与date_part兼容但extract更标准,to_char用于格式化文本;where/group by中使用需配合表达式索引以避免全表扫描。

EXTRACT 函数的基本用法和参数选择
EXTRACT 在 PostgreSQL 中用于从 TIMESTAMP、DATE 或 INTERVAL 值中抽取指定的时间字段,返回 DOUBLE PRECISION 类型数值。它不支持字符串直接解析,必须传入合法的时间类型值。
常见可提取字段包括:YEAR、MONTH、DAY、HOUR、MINUTE、SECOND、DOW(周日=0)、ISODOW(周一=1)、DOY(年中第几天)等。注意大小写敏感,必须全大写。
-
EXTRACT(YEAR FROM '2024-03-15 14:22:08'::TIMESTAMP)返回2024.0 -
EXTRACT(DOW FROM '2024-03-15'::DATE)返回5.0(因为 3 月 15 日是周五) - 错误写法:
EXTRACT(year FROM ...)—— 小写字段名会报错ERROR: function extract(unknown, unknown) does not exist
处理时区偏移时的常见陷阱
EXTRACT 默认按输入值的时区语义计算,不会自动转换为本地时区或 UTC。如果字段是 TIMESTAMP WITH TIME ZONE(即 TIMESTAMPTZ),提取结果基于该时间戳在服务器时区下的实际时刻。
例如:'2024-03-15 00:00:00+09'::TIMESTAMPTZ 存储为 UTC 时间 2024-03-14 15:00:00;若服务器时区为 UTC,则 EXTRACT(DAY FROM ...) 得到 14.0,而非直觉上的 15.0。
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布,这是目前最新的稳定版本。推荐通过官方 APT 仓库安装:先执行 sudo apt update 更新索引,再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统,在顺序扫描与 VACUUM 场景下性能提升显著,同时支持 UUID v7 原生生成函数与虚拟生成列。
- 想按原始时区提取:先用
AT TIME ZONE转回原时区,再EXTRACT,如EXTRACT(DAY FROM (t AT TIME ZONE '+09')::TIMESTAMP) - 想统一按 UTC 提取:显式转成 UTC,如
EXTRACT(HOUR FROM t AT TIME ZONE 'UTC') - 避免隐式依赖:不要假设
TIMESTAMPTZ字段的EXTRACT结果等于你看到的字符串字面值
与 DATE_PART 和 TO_CHAR 的关键区别
DATE_PART 行为几乎与 EXTRACT 一致,但接受小写字段名(如 date_part('year', ...)),且返回类型为 DOUBLE PRECISION —— 实际使用中二者可互换,但 EXTRACT 是 SQL 标准函数,兼容性更好。
TO_CHAR 则完全不同:它返回文本,支持格式化(如 'YYYY-MM-DD'),适合展示;而 EXTRACT 返回数字,适合计算、分组或条件过滤。
- 需要按“年份”分组统计?用
EXTRACT(YEAR FROM created_at),别用TO_CHAR(created_at, 'YYYY')(后者是字符串,排序/范围查询易出错) - 要获取带前导零的月份(如
'03')?必须用TO_CHAR,EXTRACT(MONTH FROM ...)只返回3.0 -
EXTRACT不支持复合格式(如“季度”需写FLOOR((EXTRACT(MONTH FROM t) - 1) / 3) + 1)
在 WHERE 和 GROUP BY 中的实用技巧
EXTRACT 可直接用于过滤和聚合,但要注意表达式是否能利用索引。对未加函数索引的列使用 EXTRACT 会导致全表扫描。
- 高频查询某个月的数据?建表达式索引:
CREATE INDEX idx_orders_month ON orders (EXTRACT(MONTH FROM order_time)) - 按“工作日/周末”分类?可用
CASE WHEN EXTRACT(ISODOW FROM t) IN (6,7) THEN 'weekend' ELSE 'weekday' END - 跨年统计每月订单量?
GROUP BY EXTRACT(YEAR FROM t), EXTRACT(MONTH FROM t)比拼接字符串更可靠 - 注意:
EXTRACT结果是浮点数,比较时别写= 1,应写= 1.0或用::INT转整型(如(EXTRACT(MONTH FROM t))::INT = 1)
真正容易被忽略的是时区上下文和索引适配——多数问题不是函数不会用,而是没意识到输入值的时区解释方式,或者在大数据量下盲目用 EXTRACT 过滤却没建对应索引。










