全部产品

TIMESTAMP WITH TIME ZONE 数据类型

更新时间:2020-03-27 10:57:00

TIMESTAMP [(scale)] WITH TIME ZONETIMASTAMP [(scale)] 的变体,与 TIMASTAMP [(scale)] 一样,它存储了年、月、日、时、分和秒等信息,阈值和精确度取决于 scale 的值。但是与 TIMASTAMP [(scale)] 不同的是它还可以存储时区信息,所以常用于存储跨地理区域的日期时间信息。

语法

  1. TIMESTAMP [(scale)] WITH TIME ZONE

参数

参数 取值范围 说明
scale 0~9 TIMESTAMP [(scale)] WITH TIME ZONE 的阈值和精确度取决于 scale 的值,最大值为 9 (纳秒,即秒数精确至小数点 9 位),最小值为 0(秒,即秒数精确至小数点 0 位),默认值为 6。

格式

TIMESTAMP WITH TIME ZONE 数据类型的默认输入输出格式由 NLS_TIMESTAMP_TZ_FORMAT 决定,运行以下 SQL 语句查看默认格式:

  1. SELECT @@NLS_TIMESTAMP_TZ_FORMAT FROM DUAL;

返回结果:

  1. DD-MON-RR HH.MI.SSXFF AM TZR

如果您需要自定义数据的格式,可以使用转换函数。在插入数据时,您可以通过函数 TO_TIMESTAMP_TZ (char,fmt) 指定数据的输入格式。查询数据时,您可以通过函数 TO_CHAR (datetime,fmt) 指定数据的输出格式。这两个转换函数会将字符串转化为参数 fmt 中定义的格式。在 fmt 未指明的情况下,使用默认格式。

取值范围

0001-01-01 00:00:00.000000000~9999-12-31 23:59:59.999999999

示例

以下示例都使用 TO_TIMESTAMP_TZ (char,fmt) 输入时间戳值。

在插入时区时, OceanBase 支持使用时区偏移量和时区区域名称:

  • 时区偏移量:与格林尼治标准时间 GMT 的差(小时和分钟)
  • 时区区域名称(TZR)及时区缩写(TZD):国家/城市 时区缩写

使用时区偏移量

执行以下语句,使用时区偏移量插入数值:

  1. SELECT TO_TIMESTAMP_TZ('2020-01-01 11:00:00 -05:00','YYYY-MM-DD HH:MI:SS TZH:TZM') FROM DUAL;

返回结果:

  1. 01-JUN-20 11.00.00.000000000 AM AMERICA/LOS_ANGELES

使用时区区域名称及时区缩写

执行以下语句,使用时区区域名称及缩写插入数值:

  1. SELECT TO_TIMESTAMP_TZ('2020-01-01 11:00:00 America/Los_Angeles PST','YYYY-MM-DD HH:MI:SS TZR TZD') FROM DUAL;

返回结果:

  1. 01-JUN-20 11.00.00.000000000 AM America/Los_Angeles PST

夏令时

OceanBase 支持夏令时且用时区缩写表示夏令时信息,以 America/Los_Angeles 为例,夏令时 PDT 从每年的 3 月的第二个星期日到 11 月的第一个星期日执行,其余时间为 PST。当插入的值中只包含时区区域名称时,OceanBase 会根据插入的时间信息判断当前插入的时区区域是否在夏令时时段,并在返回的结果中会包含时区缩写,以此指明当前时间是夏令时。

您可以执行以下示例代码:

  1. SELECT TO_TIMESTAMP_TZ('2020-02-01 11:00:00 America/Los_Angeles','YYYY-MM-DD HH:MI:SS TZR') FROM DUAL;
  2. SELECT TO_TIMESTAMP_TZ('2020-06-01 11:00:00 America/Los_Angeles','YYYY-MM-DD HH:MI:SS TZR') FROM DUAL;

返回结果:

  1. 01-JUN-20 11.00.00.000000000 AM America/Los_Angeles PST
  2. 01-JUN-20 11.00.00.000000000 AM America/Los_Angeles PDT