计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
弹性伸缩 AS
镜像服务 IMS
专属主机 DeH
函数工作流 FunctionGraph
云手机服务器 CPH
Huawei Cloud EulerOS
网络
虚拟私有云 VPC
弹性公网IP EIP
虚拟专用网络 VPN
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
VPC终端节点 VPCEP
云连接 CC
企业路由器 ER
企业交换机 ESW
全球加速 GA
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
边缘安全 EdgeSec
威胁检测服务 MTD
CDN与智能边缘
内容分发网络 CDN
CloudPond云服务
智能边缘云 IEC
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
云搜索服务 CSS
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
数据可视化 DLV
数据湖工厂 DLF
湖仓构建 LakeFormation
企业应用
云桌面 Workspace
应用与数据集成平台 ROMA Connect
云解析服务 DNS
专属云
专属计算集群 DCC
IoT物联网
IoT物联网
设备接入 IoTDA
智能边缘平台 IEF
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
国际站常见问题
ICP备案
我的凭证
支持计划
客户运营能力
合作伙伴支持计划
专业服务
区块链
区块链服务 BCS
Web3节点引擎服务 NES
解决方案
SAP
高性能计算 HPC
视频
视频直播 Live
视频点播 VOD
媒体处理 MPC
实时音视频 SparkRTC
数字内容生产线 MetaStudio
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
存储容灾服务 SDRS
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属分布式存储服务 DSS
容器
云容器引擎 CCE
容器镜像服务 SWR
应用服务网格 ASM
华为云UCS
云容器实例 CCI
管理与监管
云监控服务 CES
统一身份认证服务 IAM
资源编排服务 RFS
云审计服务 CTS
标签管理服务 TMS
云日志服务 LTS
配置审计 Config
资源访问管理 RAM
消息通知服务 SMN
应用运维管理 AOM
应用性能管理 APM
组织 Organizations
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
应用身份管理服务 OneAccess
数据库
云数据库 RDS
文档数据库服务 DDS
数据管理服务 DAS
数据复制服务 DRS
云数据库 GeminiDB
云数据库 GaussDB
分布式数据库中间件 DDM
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
人脸识别服务 FRS
图引擎服务 GES
图像识别 Image
内容审核 Moderation
文字识别 OCR
AI开发平台ModelArts
图像搜索 ImageSearch
对话机器人服务 CBS
华为HiLens
视频智能分析服务 VIAS
语音交互服务 SIS
应用中间件
分布式缓存服务 DCS
API网关 APIG
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
多活高可用服务 MAS
事件网格 EG
企业协同
华为云会议 Meeting
云通信
消息&短信 MSGSMS
云生态
合作伙伴中心
云商店
开发者工具
SDK开发指南
API签名指南
Terraform
华为云命令行工具服务 KooCLI
其他
产品价格详情
系统权限
管理控制台
客户关联华为云合作伙伴须知
消息中心
公共问题
开发与运维
应用管理与运维平台 ServiceStage
软件开发生产线 CodeArts
需求管理 CodeArts Req
部署 CodeArts Deploy
性能测试 CodeArts PerfTest
编译构建 CodeArts Build
流水线 CodeArts Pipeline
制品仓库 CodeArts Artifact
测试计划 CodeArts TestPlan
代码检查 CodeArts Check
代码托管 CodeArts Repo
云应用引擎 CAE
开天aPaaS
云消息服务 KooMessage
云手机服务 KooPhone
云空间服务 KooDrive
本文导读

日期/时间类型

更新时间:2024-08-20 GMT+08:00

GaussDB支持的日期/时间类型请参见表1。该类型的操作符和内置函数请参见时间和日期处理函数和操作符

说明:

如果其他的数据库时间格式和GaussDB的时间格式不一致,可通过修改配置参数DateStyle的值来保持一致。

表1 日期/时间类型

名称

描述

存储空间

DATE

日期。

最小值:公元前4713年,4713-01-01BC。最大值:公元5874897年,5874897-12-31AD。

在设置sql_compatibility = 'B'、b_format_version = '5.7'和b_format_dev_version = 's1'三个参数后,输入和输出格式、范围的规格有差异:

  • 输入格式:支持有分隔符YYYY-MM-DD和无分隔符 YYYYMMDD的输入格式。
    • 有分隔符场景下,日期的年、月、日之间不支持“+”、“:”作为分隔符(某些分隔符混合使用场景下不支持,规格继承已有实现。如:date '2020-12?12'),输入格式不受DateStyle参数的影响。
    • 无分隔符场景下,输入不完整时可能不会报错,但是输出结果不一定正确。
  • 输出格式:仅支持YYYY-MM-DD,且不受DateStyle参数的影响。
  • 范围:4713-01-01 BC ~ 5874897-12-31 AD。
    • SQL_MODE参数值包含“strict_trans_tables”时,非法输入或者超过范围,会报错。
    • SQL_MODE参数值不包含“strict_trans_tables”时,允许年、月、日值是0,但是输出时会按照年、月、日的顺序依次转换为合法的值,如'0000-00-10' 转换为:0002-12-10 BC。 非法输入或者超过范围时,会报warning信息,并返回0000-00-00 00:00:00值。
说明:

A兼容性下,数据库将空字符串作为NULL处理,数据类型DATE会被替换为TIMESTAMP(0) WITHOUT TIME ZONE。

4字节(兼容模式A下存储空间大小为8字节)

TIME [(p)] [WITHOUT TIME ZONE]

用于表示一天内的时间,不带时区。

p表示小数点后的精度,取值范围为0~6。

最小值:00:00:00。最大值:24:00:00。

在设置sql_compatibility = 'B'、b_format_version = '5.7'和b_format_dev_version = 's1'三个参数后,不限定于表示一天内的时间,如可以表示持续时间、相对时间等概念,且格式、范围、精度的规格有差异:

  • 输入格式:支持有分隔符[D] hh:mm:ss.ffffff和无分隔符 hhmmss.ffffff的输入格式。D是表示天数,整型数(支持负数),可选。输出时会按照1天24小时的关系换算成小时数,加hh后显示。只支持冒号“:”作为分隔符。
  • 输出格式:hh:mm:ss.ffffff。在显示的时候会自动忽略小数部分末尾的所有零。
  • 范围:-838:59:59.000000 ~ 838:59:59.000000。
    • SQL_MODE参数值包含“strict_trans_tables”时,非法输入返回00:00:00,超过范围会报错。
    • SQL_MODE参数值不包含“strict_trans_tables”时,非法输入会返回 00:00:00;合法输入但是超过范围,会返回最近的边界值。如:838:59:59.000001会返回 838:59:59,而-838:59:59.000001会返回-838:59:59。
  • 精度:p表示小数点后的精度,取值范围为0~6。当p设置超过6时,按照p为6进行处理。
    • 作为表列的数据类型时,缺省精度为0。
    • 作为表达式使用(如time '10:10:10.123456')时,缺省的精度为6。

8字节

TIME [(p)] [WITH TIME ZONE]

用于表示一天内的时间,携带时区。

p表示小数点后的精度,取值范围为0~6。

最小值:00:00:00+15:59。最大值:24:00:00-15:59。

12字节

TIMESTAMP[(p)] [WITHOUT TIME ZONE]

日期和时间,不携带时区。

p表示小数点后的精度,取值范围为0~6。

最小值:公元前4713年,4713-11-24 BC 00:00:00.000000。最大值:公元294277年,294277-01-09 AD 00:00:00.000000。

在设置sql_compatibility = 'B'、b_format_version = '5.7'和b_format_dev_version = 's1'三个参数后,会被替换为TIMESTAMP[(p)] [WITH TIME ZONE]类型,但格式、范围、精度的规格有差异:

  • 输入格式:支持有分隔符YYYY-MM-DD hh:mm:ss.ffffff+timezone和无分隔符YYYYMMDDhhmmss.ffffff的输入格式。
    • 有分隔符的情况下,日期年、月、日之间不支持“+”、“:”作为分隔符(某些分隔符混合使用场景下不支持,规格继承已有实现。如:timestamp '2020-12?12 00:00:00'),时间部分只支持冒号“:”作为分隔符。输入格式不受DateStyle参数的影响。
    • 无分隔符且输入不完整的场景下,可能不会报错,但是输出结果不一定正确。
    • 年份只有2位数时,00~69对应范围为2000~2069;70~99对应范围为:1970~1999。
    • 年份只有1位数时,如:timestamp '1-1-1 00:00:00' 结果为'0001-01-01 00:00:00'。
  • 输出格式:仅支持YYYY-MM-DD hh:mm:ss.ffffff格式,且不受DateStyle参数的影响。在显示的时候会自动忽略时间部分小数部分末尾的所有零。
  • 范围:
    • SQL_MODE参数值包含“strict_trans_tables”时,范围与TIMESTAMP[(p)] WITH TIME ZONE一致;非法输入或者超过范围,会报错。
    • SQL_MODE参数值不包含“strict_trans_tables”时,允许年、月、日值是0,但是输出时会按照年、月、日的顺序依次转换为合法的值,如'0000-00-10 00:00:00'转换为:0002-12-10 00:00:00 BC。 非法输入或者超过范围时,会报warning信息,并返回0000-00-00 00:00:00值。
  • 精度:p表示小数点后的精度,取值范围为0~6。当p设置超过6时,按照p为6进行处理。
    • 作为表列的数据类型时,缺省精度为0。
    • 作为表达式使用(如timestamp '2000-01-01 00:00:00.123456')时,缺省的精度为6。
  • 时区:支持的范围:-15:59~+15:59,或使用时区名称(请参考系统视图PG_TIMEZONE_NAMES),与TIMESTAMP[(p)] WITH TIME ZONE类型的时区规格一致。将指定时区的时间值转换为UTC-0时区的时间。显示时,再将UTC-0时区的时间转换为当前服务器时区(SHOW TIME ZONE可以查看服务器时区)的时间。因此,通过SET TIME ZONE语句更改服务器时区时,显示的结果也会变更。

8字节

TIMESTAMP[(p)][WITH TIME ZONE]

日期和时间,携带时区。TIMESTAMP的别名为TIMESTAMPTZ。

p表示小数点后的精度,取值范围为0~6。

最小值:公元前4713年,4713-11-24 BC 00:00:00.000000。最大值:公元294277年,294277-01-09 AD 00:00:00.000000。

时区更新:部分国家或地区因为政治、经济、战争等因素经常会更新时区信息, 数据库系统也因此需要同步修改时区文件以确保时间内容的正确性。

GaussDB时区类型目前只涉及timestamp with timezone,当新的时区文件生效时,不会对已有的数据进行变更,新数据会随时区文件信息进行同步调整。

8字节

SMALLDATETIME

日期和时间,不带时区。

精确到分钟,秒位大于等于30秒进一位。

最小值:公元前4713年,4713-11-24BC 00:00:00.000000。最大值:公元294277年,294277-01-09AD 00:00:00.000000。

8字节

INTERVAL DAY (l) TO SECOND (p)

时间间隔,X天X小时X分X秒。

  • l:天数的精度,取值范围为0~6。兼容性考虑,目前未实现具体功能。
  • p:秒数的精度,取值范围为0~6。小数末尾的零不显示。

16字节

INTERVAL [FIELDS] [ (p) ]

时间间隔。

  • FIELDS:可以是YEAR,MONTH,DAY,HOUR,MINUTE,SECOND,DAY TO HOUR,DAY TO MINUTE,DAY TO SECOND,HOUR TO MINUTE,HOUR TO SECOND,MINUTE TO SECOND。
  • p:秒数的精度,取值范围为0~6,且fields为SECOND,DAY TO SECOND,HOUR TO SECOND或MINUTE TO SECOND时,参数p才有效。小数末尾的零不显示。

12字节

reltime

相对时间间隔。

  • 格式为:X years X mons X days XX:XX:XX。
  • 采用儒略历计时,规定一年为365.25天,一个月为30天,计算输入值对应的相对时间间隔。

4字节

abstime

日期和时间。

  • 格式为:YYYY-MM-DD hh:mm:ss+timezone。
  • 取值范围为1901-12-13 20:45:53 GMT~2038-01-18 23:59:59 GMT,精度为秒。

4字节

datetime[(p)]

日期和时间。

仅在设置sql_compatibility = 'B'、b_format_version = '5.7'以及b_format_dev_version = 's1'三个参数后生效,datetime[(p)]类型会被替换为TIMESTAMP[(p)] WITHOUT TIME ZONE类型,但格式、范围、精度、时区处理的规格有差异:

  • 输入格式:支持有分隔符YYYY-MM-DD hh:mm:ss.ffffff+timezone和无分隔符YYYYMMDDhhmmss.ffffff的输入格式。
    • 有分隔符的情况下,日期年、月、日之间不支持“+”、“:”作为分隔符(某些分隔符混合使用场景下不支持,规格继承已有实现。如:datetime '2020-12?12 00:00:00'),时间部分只支持冒号“:”作为分隔符。输入格式不受DateStyle参数的影响。
    • 无分隔符且输入不完整的场景下,可能不会报错,但是输出结果不一定正确。
    • 年份只有2位数时,00-69对应范围为2000-2069;70-99对应范围为1970-1999。
    • 年份只有1位数时,如:datetime '1-1-1 00:00:00' 结果为'0001-01-01 00:00:00'。
  • 输出格式:仅支持YYYY-MM-DD hh:mm:ss.ffffff格式,且不受DateStyle参数的影响。在显示的时候会自动忽略时间部分小数部分末尾的所有零。
  • 范围:
    • SQL_MODE参数值包含“strict_trans_tables”时,范围与TIMESTAMP[(p)] WITHOUT TIME ZONE一致,非法输入或者超过范围时,会报错。
    • SQL_MODE参数值不包含“strict_trans_tables”时,允许年、月、日值是0,但是输出时会按照年、月、日的顺序依次转换为合法的值,如'0000-00-10 00:00:00'转换为:0002-12-10 00:00:00 BC。非法输入或者超过范围时,会报warning信息,并返回0000-00-00 00:00:00值。
  • 精度:p表示小数点后的精度,取值范围为0~6。给定精度超过6时,按照6处理。
    • 作为表列的数据类型时,缺省精度为0。
    • 作为表达式使用(如:datetime '2000-01-01 00:00:00.123456')时,缺省的精度为6。
  • 时区:支持的范围:-15:59 ~ +15:59,或使用时区名称(请参考系统视图PG_TIMEZONE_NAMES),与TIMESTAMP[(p)] WITH TIME ZONE类型的时区规格一致。将指定时区的时间值转换为当前服务器时区(SHOW TIME ZONE可以查看服务器时区)的时间。如果将转换后的日期时间存入表中,此值不会再随服务器时区的变更而再做时区转换。

8字节

year[(w)]

年份。

仅在设置sql_compatibility = 'B'参数后生效。

  • 输入格式:
    • 4位纯数字字符串:'1901'~'2155',表示从1901年到2155年。
    • 4位数字:1901~2155,表示从1901年到2155年。
    • 1位或者2位的纯数字字符串:'0'~'99',其中,'0'~'69'表示从2000年到2069年,'70'~'99'表示为从1970年到1999年。'0'、'00'表示为2000年。
    • 1位或者2位的数字:0~99,其中,1~69表示从2001年到2069年,70~99表示为从1970年到1999年。0表示为0000。
    • 其他时间函数的返回值,如now()。
  • 输出格式:仅支持YYYY格式。w表示输出格式的位数,只支持4位。若不指定,默认为4位。
  • 范围:1901~2155。
    • SQL_MODE参数值包含“strict_trans_tables”时,非法输入或者超过范围,会报错。
    • SQL_MODE参数值不包含“strict_trans_tables”时,会将非法值转为0000插入,并提示告警。

1字节

说明:
  1. 时间类型的数据在显示的时候会自动忽略末尾的所有零。
  2. 精度p默认取值为6。
  3. 对于INTERVAL类型,日期和时间在系统内部分别用int32和double类型存储,所以两者的取值范围和对应数据类型的取值范围一致。
  4. 插入时间超出范围的时候,系统可能不报错,但不保证行为正常。
说明:
在参数a_format_version值为10c和a_format_dev_version值为s1的情况下,缺省的DATE值由以下确定:
  • 年通过SYSDATE返回当年。
  • 月通过SYSDATE返回当月。
  • 日返回01(月份的第一天)。
  • 小时,分钟,秒都是0。

示例:

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
--创建表。
gaussdb=# CREATE TABLE date_type_tab(coll date);

--插入数据。
gaussdb=# INSERT INTO date_type_tab VALUES (date '12-10-2010');

--查看数据。
gaussdb=# SELECT * FROM date_type_tab;
        coll         
---------------------
 2010-12-10
(1 row)

--删除表。
gaussdb=# DROP TABLE date_type_tab;

--创建表。
gaussdb=# CREATE TABLE time_type_tab (da time without time zone ,dai time with time zone,dfgh timestamp without time zone,dfga timestamp with time zone, vbg smalldatetime);

--插入数据。
gaussdb=# INSERT INTO time_type_tab VALUES ('21:21:21','21:21:21 pst','2010-12-12','2013-12-11 pst','2003-04-12 04:05:06');

--查看数据。
gaussdb=# SELECT * FROM time_type_tab;
    da    |     dai     |        dfgh         |          dfga          |         vbg         
----------+-------------+---------------------+------------------------+---------------------
 21:21:21 | 21:21:21-08 | 2010-12-12 00:00:00 | 2013-12-11 16:00:00+08 | 2003-04-12 04:05:00
(1 row)

--删除表。
gaussdb=# DROP TABLE time_type_tab;

--创建表。
gaussdb=# CREATE TABLE day_type_tab (a int,b INTERVAL DAY(3) TO SECOND (4)); 

--插入数据。
gaussdb=# INSERT INTO day_type_tab VALUES (1, INTERVAL '3' DAY);

--查看数据。
gaussdb=# SELECT * FROM day_type_tab;
 a |   b    
---+--------
 1 | 3 days
(1 row)

--删除表。
gaussdb=# DROP TABLE day_type_tab;

--创建表。
gaussdb=# CREATE TABLE year_type_tab(a int, b interval year (6));

--插入数据。
gaussdb=# INSERT INTO year_type_tab VALUES(1,interval '2' year);

--查看数据。
gaussdb=# SELECT * FROM year_type_tab;
 a |    b    
---+---------
 1 | 2 years
(1 row)

--删除表。
gaussdb=# DROP TABLE year_type_tab;

-- B兼容模式下datetime和timestamp数据类型示例。
-- 创建B兼容模式下的数据库。
-- 切换到B兼容模式下的数据库。
gaussdb=# CREATE DATABASE gaussdb_m dbcompatibility='B';
gaussdb=# \c gaussdb_m;

-- 设置兼容版本控制参数。
gaussdb_m=# SET b_format_version = '5.7';
gaussdb_m=# SET b_format_dev_version = 's1';

-- 创建表。
gaussdb_m=# CREATE TABLE datetime_typ_tab(col1 datetime, col2 timestamp);

-- 插入数据。
gaussdb_m=# INSERT INTO datetime_typ_tab VALUES ('2003-04-12 04:05:06+09:00', '2003-04-12 04:05:06+09:00');

-- 查看数据。
gaussdb_m=# SELECT * FROM datetime_typ_tab;
        col1         |        col2         
---------------------+---------------------
 2003-04-12 03:05:06 | 2003-04-12 03:05:06
(1 row)

-- 删除表。
gaussdb_m=# DROP TABLE datetime_typ_tab;

-- 创建表。
gaussdb_m=# CREATE TABLE year_typ_tab(col1 year, col2 year(4));

-- 插入数据。
gaussdb_m=# INSERT INTO year_typ_tab VALUES ('2023', now());

-- 查看数据。
gaussdb_m=# SELECT * FROM year_typ_tab;
 col1 | col2 
------+------
 2023 | 2023
(1 row)

-- 删除表和数据库。
gaussdb_m=# DROP TABLE year_typ_tab;
gaussdb_m=# \c postgres;
gaussdb=# DROP DATABASE gaussdb_m;

-- 重置参数。
gaussdb=# RESET ALL;

日期输入

日期和时间的输入几乎可以是任何合理的格式,包括ISO-8601格式、SQL-兼容格式或者其它的格式。系统支持按照日、月、年的顺序自定义日期输入。如果把DateStyle参数设置为MDY就按照“月-日-年”解析,设置为DMY就按照“日-月-年”解析,设置为YMD就按照“年-月-日”解析。

日期的文本输入需要加单引号包围,语法如下:

type [ ( p ) ] 'value'

可选的精度声明中的p是一个整数,表示在秒域中小数部分的位数。表2显示了date类型的输入格式。

表2 日期输入格式

例子

描述

1999-01-08

ISO 8601格式(建议格式),任何方式下都是1999年1月8日。

January 8, 1999

在任何datestyle输入模式下都无歧义。

1/8/1999

有歧义,在MDY模式下是1月8日,在DMY模式下是8月1日。

1/18/1999

MDY模式下是1月18日,其它模式下被拒绝。

01/02/03

  • MDY模式下的2003年1月2日。
  • DMY模式下的2003年2月1日。
  • YMD模式下的2001年2月3日。

1999-Jan-08

任何模式下都是1月8日。

Jan-08-1999

任何模式下都是1月8日。

08-Jan-1999

任何模式下都是1月8日。

99-Jan-08

YMD模式下是1月8日,否则错误。

08-Jan-99

1月8日,除了在YMD模式下是错误的之外。

Jan-08-99

1月8日,除了在YMD模式下是错误的之外。

19990108

ISO 8601格式,任何模式下都是1999年1月8日。

990108

ISO 8601格式,任何模式下都是1999年1月8日。

1999.008

年和年里的第几天。

J2451187

儒略日。

January 8, 99 BC

公元前99年。

示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
--创建表。
gaussdb=# CREATE TABLE date_type_tab(coll date);

--插入数据。
gaussdb=# INSERT INTO date_type_tab VALUES (date '12-10-2010');

--查看数据。
gaussdb=# SELECT * FROM date_type_tab;
        coll         
---------------------
 2010-12-10
(1 row)

--查看日期格式。
gaussdb=# SHOW datestyle;
 DateStyle 
-----------
 ISO, MDY
(1 row)

--设置日期格式。
gaussdb=# SET datestyle='YMD';
SET

--插入数据。
gaussdb=# INSERT INTO date_type_tab VALUES(date '2010-12-11');

--查看数据。
gaussdb=# SELECT * FROM date_type_tab;
        coll         
---------------------
 2010-12-10
 2010-12-11
(2 rows)

--删除表。
gaussdb=# DROP TABLE date_type_tab;

时间

时间类型包括time [ (p) ] without time zone和time [ (p) ] with time zone。如果只写time等效于time without time zone。

如果在time without time zone类型的输入中声明了时区,则会忽略这个时区。

时间输入类型的详细信息请参见表3,时区输入类型的详细信息请参见表4

表3 时间输入

例子

描述

05:06.8

ISO 8601

4:05:06

ISO 8601

4:05

ISO 8601

040506

ISO 8601

4:05 AM

与04:05一样,输入小时数必须<= 12

4:05 PM

与16:05一样,输入小时数必须<= 12

04:05:06.789-8

ISO 8601

04:05:06-08:00

ISO 8601

04:05-08:00

ISO 8601

040506-08

ISO 8601

04:05:06 PST

缩写的时区

2003-04-12 04:05:06 America/New_York

用名称声明的时区

表4 时区输入

例子

描述

PST

太平洋标准时间(Pacific Standard Time)

America/New_York

完整时区名称

-8:00

ISO 8601与PST的偏移

-800

ISO 8601与PST的偏移

-8

ISO 8601与PST的偏移

示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
gaussdb=# SELECT time '04:05:06';
   time   
----------
 04:05:06
(1 row)

gaussdb=# SELECT time '04:05:06 PST';
   time   
----------
 04:05:06
(1 row)

gaussdb=# SELECT time with time zone '04:05:06 PST';
   timetz    
-------------
 04:05:06-08
(1 row)

特殊值

GaussDB支持几个特殊值,在读取的时候将被转换成普通的日期/时间值,请参考表5

表5 特殊值

输入字符串

适用类型

描述

epoch

date,timestamp

1970-01-01 00:00:00+00 (Unix系统零时)

infinity

timestamp

无穷大,比任何其他时间戳都晚

-infinity

timestamp

无穷小,比任何其他时间戳都早

now

date,time,timestamp

当前事务的开始时间

today

date,timestamp

今日午夜零时

tomorrow

date,timestamp

明日午夜零时

yesterday

date,timestamp

昨日午夜零时

allballs

time

00:00:00.00 UTC

示例:

--创建表。
gaussdb=# CREATE TABLE realtime_type_special(col1 varchar(20), col2 date, col3 timestamp, col4 time);

--插入数据。
gaussdb=# INSERT INTO realtime_type_special VALUES('epoch', 'epoch', 'epoch', NULL);
gaussdb=# INSERT INTO realtime_type_special VALUES('now', 'now', 'now', 'now');
gaussdb=# INSERT INTO realtime_type_special VALUES('today', 'today', 'today', NULL);
gaussdb=# INSERT INTO realtime_type_special VALUES('tomorrow', 'tomorrow', 'tomorrow', NULL);
gaussdb=# INSERT INTO realtime_type_special VALUES('yesterday', 'yesterday', 'yesterday', NULL);

--查看数据。
gaussdb=# SELECT * FROM realtime_type_special;
   col1    |        col2         |            col3            |      col4
-----------+---------------------+----------------------------+-----------------
 epoch     | 1970-01-01 00:00:00 | 1970-01-01 00:00:00        |
 now       | 2023-02-27 11:38:13 | 2023-02-27 11:38:13.032815 | 11:38:13.032815
 today     | 2023-02-27 00:00:00 | 2023-02-27 00:00:00        |
 tomorrow  | 2023-02-28 00:00:00 | 2023-02-28 00:00:00        |
 yesterday | 2023-02-26 00:00:00 | 2023-02-26 00:00:00        |
(5 rows)

gaussdb=# SELECT * FROM realtime_type_special WHERE col3 < 'infinity';
   col1    |        col2         |            col3            |      col4
-----------+---------------------+----------------------------+-----------------
 epoch     | 1970-01-01 00:00:00 | 1970-01-01 00:00:00        |
 now       | 2023-02-27 11:38:13 | 2023-02-27 11:38:13.032815 | 11:38:13.032815
 today     | 2023-02-27 00:00:00 | 2023-02-27 00:00:00        |
 tomorrow  | 2023-02-28 00:00:00 | 2023-02-28 00:00:00        |
 yesterday | 2023-02-26 00:00:00 | 2023-02-26 00:00:00        |
(5 rows)

gaussdb=# SELECT * FROM realtime_type_special WHERE col3 > '-infinity';
   col1    |        col2         |            col3            |      col4
-----------+---------------------+----------------------------+-----------------
 epoch     | 1970-01-01 00:00:00 | 1970-01-01 00:00:00        |
 now       | 2023-02-27 11:38:13 | 2023-02-27 11:38:13.032815 | 11:38:13.032815
 today     | 2023-02-27 00:00:00 | 2023-02-27 00:00:00        |
 tomorrow  | 2023-02-28 00:00:00 | 2023-02-28 00:00:00        |
 yesterday | 2023-02-26 00:00:00 | 2023-02-26 00:00:00        |
(5 rows)

gaussdb=# SELECT * FROM realtime_type_special WHERE col3 > 'now';
   col1   |        col2         |        col3         | col4
----------+---------------------+---------------------+------
 tomorrow | 2023-02-28 00:00:00 | 2023-02-28 00:00:00 |
(1 row)

gaussdb=# SELECT * FROM realtime_type_special WHERE col3 = 'today';
 col1  |        col2         |        col3         | col4
-------+---------------------+---------------------+------
 today | 2023-02-27 00:00:00 | 2023-02-27 00:00:00 |
(1 row)

gaussdb=# SELECT * FROM realtime_type_special WHERE col3 = 'tomorrow';
   col1   |        col2         |        col3         | col4
----------+---------------------+---------------------+------
 tomorrow | 2023-02-28 00:00:00 | 2023-02-28 00:00:00 |
(1 row)

gaussdb=# SELECT * FROM realtime_type_special WHERE col3 > 'yesterday';
   col1   |        col2         |            col3            |      col4
----------+---------------------+----------------------------+-----------------
 now      | 2023-02-27 11:38:13 | 2023-02-27 11:38:13.032815 | 11:38:13.032815
 today    | 2023-02-27 00:00:00 | 2023-02-27 00:00:00        |
 tomorrow | 2023-02-28 00:00:00 | 2023-02-28 00:00:00        |
(3 rows)

gaussdb=# SELECT TIME 'allballs';
   time
----------
 00:00:00
(1 row)

--删除表。
gaussdb=# DROP TABLE realtime_type_special;

时间段输入

reltime的输入方式可以采用任何合法的时间段文本格式,包括数字形式(含负数和小数)及时间形式,其中时间形式的输入支持SQL标准格式、ISO-8601格式等。另外,文本输入需要加单引号。

时间段输入的详细信息请参考表6

表6 时间段输入

输入示例

输出结果

描述

60

2 mons

采用数字表示时间段,默认单位是day,可以是小数或负数。特别的,负数时间段,在语义上,可以理解为“早于多久”。

31.25

1 mons 1 days 06:00:00

-365

-12 mons -5 days

1 years 1 mons 8 days 12:00:00

1 years 1 mons 8 days 12:00:00

采用POSTGRES格式表示时间段,可以正负混用,不区分大小写,输出结果为将输入时间段计算并转换得到的简化POSTGRES格式时间段。

-13 months -10 hours

-1 years -25 days -04:00:00

-2 YEARS +5 MONTHS 10 DAYS

-1 years -6 mons -25 days -06:00:00

P-1.1Y10M

-3 mons -5 days -06:00:00

采用ISO-8601格式表示时间段,可以正负混用,不区分大小写,输出结果为将输入时间段计算并转换得到的简化POSTGRES格式时间段。

-12H

-12:00:00

示例:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
--创建表。
gaussdb=# CREATE TABLE reltime_type_tab(col1 character(30), col2 reltime);

--插入数据。
gaussdb=# INSERT INTO reltime_type_tab VALUES ('90', '90');
gaussdb=# INSERT INTO reltime_type_tab VALUES ('-366', '-366');
gaussdb=# INSERT INTO reltime_type_tab VALUES ('1975.25', '1975.25');
gaussdb=# INSERT INTO reltime_type_tab VALUES ('-2 YEARS +5 MONTHS 10 DAYS', '-2 YEARS +5 MONTHS 10 DAYS');
gaussdb=# INSERT INTO reltime_type_tab VALUES ('30 DAYS 12:00:00', '30 DAYS 12:00:00');
gaussdb=# INSERT INTO reltime_type_tab VALUES ('P-1.1Y10M', 'P-1.1Y10M');

--查看数据。
gaussdb=# SELECT * FROM reltime_type_tab;
              col1              |                col2                 
--------------------------------+-------------------------------------
 90                             | 3 mons
 -366                           | -1 years -18:00:00
 1975.25                        | 5 years 4 mons 29 days
 -2 YEARS +5 MONTHS 10 DAYS     | -1 years -6 mons -25 days -06:00:00
 30 DAYS 12:00:00               | 1 mon 12:00:00
 P-1.1Y10M                      | -3 mons -5 days -06:00:00
(6 rows)

--删除表。
gaussdb=# DROP TABLE reltime_type_tab;

我们使用cookie来确保您的高速浏览体验。继续浏览本站,即表示您同意我们使用cookie。 详情

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容