↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

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

time 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 名称与别名: timetz

一天中的时间,包含时区

time [ ( p ) ] with time zone
目录名称
pg_catalog.timetz
类型 OID
1266
类型种类
基础类型
声明长度
12 字节
存储策略
plain
输入函数
timetz_in
输出函数
timetz_out
手册中的声明
time [ ( p ) ] with time zone
存储大小
12 字节
手册说明
一天中的时间(无日期),带时区
下限
00:00:00+1559
上限
24:00:00-1559
精度
1 微秒

系统目录属性

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

oid
1266
descr
time of day with time zone
typacl
_null_
typlen
12
typelem
0
typname
timetz
typsend
timetz_send
typtype
b
typalign
d
typarray
0
typbyval
f
typdelim
','
typinput
timetz_in
typmodin
timetztypmodin
typndims
0
typowner
POSTGRES
typrelid
0
typmodout
timetztypmodout
typoutput
timetz_out
typtypmod
-1
typanalyze
-
typdefault
_null_
typnotnull
f
typreceive
timetz_recv
typstorage
p
typbasetype
0
typcategory
D
typcollation
0
typisdefined
t
typnamespace
pg_catalog
typsubscript
-
typdefaultbin
_null_
array_type_oid
1270
typispreferred
f
array_type_name
_timetz

类型转换 4

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

源类型目标类型转换上下文转换方式函数
timetimetz隐式函数timetz(time)
timestamptztimetz赋值函数timetz(timestamptz)
timetztime赋值函数time(timetz)
timetztimetz隐式函数timetz(timetz,int4)

运算符重载 11

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

运算符左操作数右操作数返回类型含义实现函数
=timetztimetzbool等于。timetz_eq
<>timetztimetzbool不等于。timetz_ne
<timetztimetzbool小于。timetz_lt
<=timetztimetzbool小于或等于。timetz_le
>timetztimetzbool大于。timetz_gt
>=timetztimetzbool大于或等于。timetz_ge
+datetimetztimestamptz将日期与带时区时间转换为带时区时间戳。datetimetz_pl
+timetzdatetimestamptz将带时区时间与日期转换为带时区时间戳。timetzdate_pl
+timetzintervaltimetz相加。timetz_pl_interval
-timetzintervaltimetz相减。timetz_mi_interval
+intervaltimetztimetz相加。interval_pl_timetz

操作符类 5

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

操作符类索引方法输入类型操作符族默认存储类型
timetz_opsbtreetimetzbtree/timetz_ops是与输入类型相同
timetz_opshashtimetzhash/timetz_ops是与输入类型相同
timetz_minmax_opsbrintimetzbrin/timetz_minmax_ops是timetz
timetz_minmax_multi_opsbrintimetzbrin/timetz_minmax_multi_ops否timetz
timetz_bloom_opsbrintimetzbrin/timetz_bloom_ops否timetz

版本比较

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

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

文档与源码

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

相关条目

全部数据类型 · 下载此版本 JSON · 最早收录的样本不代表该类型的实际引入版本。