百科 / 数据类型 / 日期与时间

timestamp with time zone

日期和时间，包含时区

当前查看 PostgreSQL 18。

中文定义与说明

日期和时间，包含时区

同版本中文手册节选

PostgreSQL 支持完整的一组 SQL 日期和时间类型，如表 8.9 所示。这些数据类型上可用的操作见第 9.9 节。日期按格里高利历计算，即使是在该历法启用之前的年份也是如此（更多信息见第 B.6 节）。

time、timestamp 和 interval 都接受一个可选精度值 p，用来指定在秒字段中保留多少位小数。默认情况下，对精度没有显式上界。p 的允许范围是 0 到 6。

interval 类型还有一个附加选项，可以通过写出下面这些短语之一来限制所存储字段的集合：

注意，如果同时指定了 fields 和 p，那么 fields 必须包含 SECOND，因为精度只作用于秒。

查看完整中文手册与上下文。

PG10–20 核心源码清单。类型转换与操作符类列出源码显式声明的关系；缺少记录不能排除通过其他机制进行转换或使用索引。

定义

SQL 名称与别名： timestamptz

日期和时间，包含时区

timestamp [ ( p ) ] with time zone

目录名称: pg_catalog.timestamptz
类型 OID: 1184
类型种类: 基础类型
声明长度: 8 字节
存储策略: plain
输入函数: timestamptz_in
输出函数: timestamptz_out
手册中的声明: timestamp [ ( p ) ] with time zone
存储大小: 8 字节
手册说明: 包括日期和时间，有时区
下限: 公元前 4713 年
上限: 公元 294276 年
精度: 1 微秒

系统目录属性

此构建的源码初始化值。字段含义参见 pg_type 。包含头文件默认值；依赖构建的常量保留符号形式，不作为服务器运行时实测。

oid: 1184
descr: date and time with time zone
typacl: _null_
typlen: 8
typelem: 0
typname: timestamptz
typsend: timestamptz_send
typtype: b
typalign: d
typarray: 0
typbyval: FLOAT8PASSBYVAL
typdelim: ','
typinput: timestamptz_in
typmodin: timestamptztypmodin
typndims: 0
typowner: POSTGRES
typrelid: 0
typmodout: timestamptztypmodout
typoutput: timestamptz_out
typtypmod: -1
typanalyze: -
typdefault: _null_
typnotnull: f
typreceive: timestamptz_recv
typstorage: p
typbasetype: 0
typcategory: D
typcollation: 0
typisdefined: t
typnamespace: pg_catalog
typsubscript: -
typdefaultbin: _null_
array_type_oid: 1185
typispreferred: t
array_type_name: _timestamptz

类型转换 7

与此类型相关的显式 pg_cast 记录。PostgreSQL 还支持 pg_cast 之外的类型转换，缺少记录不能证明转换不可能。

源类型	目标类型	转换上下文	转换方式	函数
`date`	`timestamptz`	`隐式`	`函数`	`timestamptz(date)`
`timestamp`	`timestamptz`	`隐式`	`函数`	`timestamptz(timestamp)`
`timestamptz`	`date`	`赋值`	`函数`	`date(timestamptz)`
`timestamptz`	`time`	`赋值`	`函数`	`time(timestamptz)`
`timestamptz`	`timestamp`	`赋值`	`函数`	`timestamp(timestamptz)`
`timestamptz`	`timetz`	`赋值`	`函数`	`timetz(timestamptz)`
`timestamptz`	`timestamptz`	`隐式`	`函数`	`timestamptz(timestamptz,int4)`

运算符重载 34

每种操作数签名均为独立重载。实现函数和返回类型来自同一源码构建。

运算符	左操作数	右操作数	返回类型	含义	实现函数
`=`	`timestamptz`	`timestamptz`	`bool`	等于。	`timestamptz_eq`
`<>`	`timestamptz`	`timestamptz`	`bool`	不等于。	`timestamptz_ne`
`<`	`timestamptz`	`timestamptz`	`bool`	小于。	`timestamptz_lt`
`<=`	`timestamptz`	`timestamptz`	`bool`	小于或等于。	`timestamptz_le`
`>`	`timestamptz`	`timestamptz`	`bool`	大于。	`timestamptz_gt`
`>=`	`timestamptz`	`timestamptz`	`bool`	大于或等于。	`timestamptz_ge`
`+`	`timestamptz`	`interval`	`timestamptz`	相加。	`timestamptz_pl_interval`
`-`	`timestamptz`	`timestamptz`	`interval`	相减。	`timestamptz_mi`
`-`	`timestamptz`	`interval`	`timestamptz`	相减。	`timestamptz_mi_interval`
`<`	`date`	`timestamptz`	`bool`	小于。	`date_lt_timestamptz`
`<=`	`date`	`timestamptz`	`bool`	小于或等于。	`date_le_timestamptz`
`=`	`date`	`timestamptz`	`bool`	等于。	`date_eq_timestamptz`
`>=`	`date`	`timestamptz`	`bool`	大于或等于。	`date_ge_timestamptz`
`>`	`date`	`timestamptz`	`bool`	大于。	`date_gt_timestamptz`
`<>`	`date`	`timestamptz`	`bool`	不等于。	`date_ne_timestamptz`
`<`	`timestamptz`	`date`	`bool`	小于。	`timestamptz_lt_date`
`<=`	`timestamptz`	`date`	`bool`	小于或等于。	`timestamptz_le_date`
`=`	`timestamptz`	`date`	`bool`	等于。	`timestamptz_eq_date`
`>=`	`timestamptz`	`date`	`bool`	大于或等于。	`timestamptz_ge_date`
`>`	`timestamptz`	`date`	`bool`	大于。	`timestamptz_gt_date`
`<>`	`timestamptz`	`date`	`bool`	不等于。	`timestamptz_ne_date`
`<`	`timestamp`	`timestamptz`	`bool`	小于。	`timestamp_lt_timestamptz`
`<=`	`timestamp`	`timestamptz`	`bool`	小于或等于。	`timestamp_le_timestamptz`
`=`	`timestamp`	`timestamptz`	`bool`	等于。	`timestamp_eq_timestamptz`
`>=`	`timestamp`	`timestamptz`	`bool`	大于或等于。	`timestamp_ge_timestamptz`
`>`	`timestamp`	`timestamptz`	`bool`	大于。	`timestamp_gt_timestamptz`
`<>`	`timestamp`	`timestamptz`	`bool`	不等于。	`timestamp_ne_timestamptz`
`<`	`timestamptz`	`timestamp`	`bool`	小于。	`timestamptz_lt_timestamp`
`<=`	`timestamptz`	`timestamp`	`bool`	小于或等于。	`timestamptz_le_timestamp`
`=`	`timestamptz`	`timestamp`	`bool`	等于。	`timestamptz_eq_timestamp`
`>=`	`timestamptz`	`timestamp`	`bool`	大于或等于。	`timestamptz_ge_timestamp`
`>`	`timestamptz`	`timestamp`	`bool`	大于。	`timestamptz_gt_timestamp`
`<>`	`timestamptz`	`timestamp`	`bool`	不等于。	`timestamptz_ne_timestamp`
`+`	`interval`	`timestamptz`	`timestamptz`	相加。	`interval_pl_timestamptz`

操作符类 5

声明输入类型与此类型相符的操作符类。多态操作符类、类型转换和表达式索引还可能提供其他索引路径；不能仅凭此表判断是否支持索引。

操作符类	索引方法	输入类型	操作符族	默认	存储类型
`timestamptz_ops`	`btree`	`timestamptz`	`btree/datetime_ops`	`是`	`与输入类型相同`
`timestamptz_ops`	`hash`	`timestamptz`	`hash/timestamptz_ops`	`是`	`与输入类型相同`
`timestamptz_minmax_ops`	`brin`	`timestamptz`	`brin/datetime_minmax_ops`	`是`	`timestamptz`
`timestamptz_minmax_multi_ops`	`brin`	`timestamptz`	`brin/datetime_minmax_multi_ops`	`否`	`timestamptz`
`timestamptz_bloom_ops`	`brin`	`timestamptz`	`brin/datetime_bloom_ops`	`否`	`timestamptz`

版本比较

PostgreSQL 17 → 18。属性比较不包含构建标识和说明正文；原始目录字段与源描述保留原文。

这两个样本的系统目录和结构化属性没有变化。

文档与源码

构建: 18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
指纹: 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

快速链接

timestamp with time zone

中文定义与说明

同版本中文手册节选

定义

系统目录属性

类型转换 7

运算符重载 34

操作符类 5

版本比较

文档与源码

相关条目