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 。包含头文件默认值;依赖构建的常量保留符号形式,不作为服务器运行时实测。
oid1266descrtime of day with time zonetypacl_null_typlen12typelem0typnametimetztypsendtimetz_sendtyptypebtypaligndtyparray0typbyvalftypdelim','typinputtimetz_intypmodintimetztypmodintypndims0typownerPOSTGREStyprelid0typmodouttimetztypmodouttypoutputtimetz_outtyptypmod-1typanalyze-typdefault_null_typnotnullftypreceivetimetz_recvtypstorageptypbasetype0typcategoryDtypcollation0typisdefinedttypnamespacepg_catalogtypsubscript-typdefaultbin_null_array_type_oid1270typispreferredfarray_type_name_timetz
类型转换 4
与此类型相关的显式 pg_cast 记录。PostgreSQL 还支持 pg_cast 之外的类型转换,缺少记录不能证明转换不可能。
运算符重载 11
每种操作数签名均为独立重载。实现函数和返回类型来自同一源码构建。
| 运算符 | 左操作数 | 右操作数 | 返回类型 | 含义 | 实现函数 |
|---|---|---|---|---|---|
= | timetz | timetz | bool | 等于。 | timetz_eq |
<> | timetz | timetz | bool | 不等于。 | timetz_ne |
< | timetz | timetz | bool | 小于。 | timetz_lt |
<= | timetz | timetz | bool | 小于或等于。 | timetz_le |
> | timetz | timetz | bool | 大于。 | timetz_gt |
>= | timetz | timetz | bool | 大于或等于。 | timetz_ge |
+ | date | timetz | timestamptz | 将日期与带时区时间转换为带时区时间戳。 | datetimetz_pl |
+ | timetz | date | timestamptz | 将带时区时间与日期转换为带时区时间戳。 | timetzdate_pl |
+ | timetz | interval | timetz | 相加。 | timetz_pl_interval |
- | timetz | interval | timetz | 相减。 | timetz_mi_interval |
+ | interval | timetz | timetz | 相加。 | interval_pl_timetz |
操作符类 5
声明输入类型与此类型相符的操作符类。多态操作符类、类型转换和表达式索引还可能提供其他索引路径;不能仅凭此表判断是否支持索引。
| 操作符类 | 索引方法 | 输入类型 | 操作符族 | 默认 | 存储类型 |
|---|---|---|---|---|---|
timetz_ops | btree | timetz | btree/timetz_ops | 是 | 与输入类型相同 |
timetz_ops | hash | timetz | hash/timetz_ops | 是 | 与输入类型相同 |
timetz_minmax_ops | brin | timetz | brin/timetz_minmax_ops | 是 | timetz |
timetz_minmax_multi_ops | brin | timetz | brin/timetz_minmax_multi_ops | 否 | timetz |
timetz_bloom_ops | brin | timetz | brin/timetz_bloom_ops | 否 | timetz |
版本比较
PostgreSQL 17 → 18。属性比较不包含构建标识和说明正文;原始目录字段与源描述保留原文。
这两个样本的系统目录和结构化属性没有变化。
文档与源码
- 构建
- 18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 指纹
555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f
相关条目
全部数据类型 · 下载此版本 JSON · 最早收录的样本不代表该类型的实际引入版本。