Menu

PostgreSQL timestamp 和 timestamptz(带时区)的区别

timestamptz 存储一个时间点,并按会话时区显示;timestamp 存储不带时区的挂钟时间。两者都不会保存你写入的时区。几乎所有场景都用 timestamptz。

本页包含可运行的编辑器。编辑、运行,立即查看输出。

PostgreSQL 有两种时间戳类型。timestamptz(timestamp with time zone)存储一个确切的时间点:输入时转换成 UTC,输出时按会话时区显示。timestamp(timestamp without time zone)存储日期和不带时区的挂钟时间。两者都不会保存你写入的时区。凡是在某个时间点发生的事情,都用 timestamptz。

同样的输入分别得到 2026-03-01 12:00:00 和 2026-03-01 21:00:00+09。timestamptz 的值仍是之前那个时间点,只是现在按东京时间显示。timestamp 的值没有可以转换的时区,所以不会变。

输入中的时区会怎样

当输入带有偏移量时,timestamptz 用它来确定时间点。timestamp 则会悄悄把它丢掉:

plain 是 2026-03-01 12:00:00,+02 被丢弃了。with_zone 是 2026-03-01 10:00:00+00,也就是 UTC 下的同一时刻。时间差出好几个小时通常就是这样造成的:应用把带偏移量的 ISO 字符串写进 timestamp 列,偏移量就消失了。

什么时候用哪种

用途类型
创建、更新、支付、登录时间timestamptz
跟随当地时钟的定时时间(“每天在用户所在时区的 9:00”)timestamp 加一个时区名列
没有时间的日历日期date
一段时长interval

两种类型都占 8 个字节,精确到微秒。用 SET TIME ZONE 'Europe/Paris' 设置会话时区。要用完整的时区名,不要用 EST 这样的缩写:缩写是固定的偏移量,会忽略夏令时。

用 AT TIME ZONE 在时区之间转换

AT TIME ZONE 可以双向使用。作用在 timestamptz 上时,它以 timestamp 返回该时区的挂钟时间。作用在 timestamp 上时,它把这个值当作该时区的本地时间,返回对应的 timestamptz 时间点。

7 月份 UTC 的中午是纽约的 08:00,巴黎的 9:00 是 UTC 的 07:00。第一种形式用来按用户的时区显示时间,第二种用来把用户输入的本地时间转换成时间点。

夏令时和时间间隔运算

给 timestamptz 加上 interval '1 day',在夏令时切换前后会保持相同的本地时钟时间。加上 '24 hours' 则是精确地加小时数。美国在 2026 年 3 月 8 日把时钟拨快:

第一个得到 2026-03-08 12:00:00-04,第二个得到 2026-03-08 13:00:00-04。结果取决于会话时区,所以做日期运算的代码要显式地设置时区。

当前时间

now() 和 current_timestamp 以 timestamptz 返回当前事务开始的时间,一条语句涉及的每一行得到的都是同一个值。clock_timestamp() 每次调用都返回真实时间。current_date 返回 date,localtimestamp 返回 timestamp。典型的列定义是 created_at timestamptz NOT NULL DEFAULT now()。

把 timestamp 列转换成 timestamptz

如果已有的 timestamp 列中存的是 UTC 时间,就用 USING ... AT TIME ZONE 'UTC' 来转换,这样这些值会被当作 UTC 读取,而不是按会话时区读取:

现在的值是 2026-01-15 09:30:00+01,按柏林时间显示。这个修改会重写表,所以大表要在空闲时段运行(类型修改见 ALTER TABLE)。date_trunc、extract 和 age 等函数见日期函数页面,完整的输入格式见日期/时间类型章节。

常见问题

PostgreSQL 的 timestamptz 会存储时区吗?

不会。它把输入转换成 UTC,只存储这个时间点。你写入的时区会丢失;输出时按会话的 TimeZone 设置显示。如果之后还需要时区,就把时区名单独存在一个 text 列中。

now() 和 clock_timestamp() 有什么区别?

now()(和 current_timestamp 相同)返回当前事务开始的时间,所以在事务中的每一行、每条语句里都保持不变。clock_timestamp() 返回调用那一刻的实际时间,即使在同一条语句中也会变化。

PostgreSQL 中怎么获取当前日期?

current_date 返回会话时区下今天的日期。now()::date 结果相同,localtimestamp 则以不带时区的 timestamp 返回当前的日期和时间。

PostgreSQL 中时间戳占用多少空间?

timestamp 和 timestamptz 都占 8 个字节,精度到微秒。date 占 4 个字节。

Coddy 编程语言插图

和 Coddy 一起学编程

开始