第三十七章 SQL函数 CURRENT_TIMESTAMP

日期/时间函数，返回当前本地日期和时间。

大纲

CURRENT_TIMESTAMP
CURRENT_TIMESTAMP(precision)

参数

precision - 一个正整数，它将时间精度指定为小数秒的位数。
默认值是0(没有小数秒);
这个默认值是可配置的。

CURRENT_TIMESTAMP返回TIMESTAMP数据类型。

描述

CURRENT_TIMESTAMP要么不接受参数，要么接受精度参数。
不允许使用空参数括号。

CURRENT_TIMESTAMP返回当前时区的本地日期和时间;
它会根据当地的时间变化进行调整，例如日光节约时间。

CURRENT_TIMESTAMP可以返回%timestamp数据类型格式(yyyy-mm-dd hh:mm:ss.ffff)或%PosixTime数据类型格式(编码的64位带符号整数)的时间戳。
以下规则决定返回哪种时间戳格式:

如果将当前时间戳提供给数据类型为%PosixTime的字段，则当前时间戳值将以PosixTime数据类型格式返回。
例如，WHERE PosixField=CURRENT_TIMESTAMP or INSERT INTO MyTable (PosixField) VALUES (CURRENT_TIMESTAMP).
如果将当前的时间戳提供给数据类型为%timestamp的字段，则以timestamp数据类型格式返回当前的时间戳值。
例如WHERE TSField=CURRENT_TIMESTAMP or INSERT INTO MyTable (TSField) VALUES (CURRENT_TIMESTAMP).
如果没有上下文提供当前时间戳，则以timestamp数据类型格式返回当前时间戳值。
例如:SELECT CURRENT_TIMESTAMP。

可以使用$HOROLOG以内部格式存储或返回当前本地日期和时间。

要更改默认的datetime字符串格式，使用SET OPTION命令和各种日期和时间选项。

当使用CREATE TABLE或ALTER TABLE定义datetime字段时，可以指定CURRENT_TIMESTAMP(带精度或不带精度)作为字段的默认值。
CURRENT_TIMESTAMP可以被指定为数据类型为%Library的字段的默认值。
PosixTime或%Library.TimeStamp;
当前日期和时间以字段的数据类型指定的格式存储。

精确到小数部分的秒

CURRENT_TIMESTAMP有两种语法形式:

如果没有参数括号，CURRENT_TIMESTAMP在功能上与NOW相同。
它使用系统范围内的默认时间精度。
带有圆括号的参数CURRENT_TIMESTAMP(precision)在功能上与GETDATE相同，除了CURRENT_TIMESTAMP()精度参数是强制性的。
CURRENT_TIMESTAMP()总是返回指定的精度，并忽略配置的系统范围内的缺省时间精度。

分数秒总是被截断，而不是四舍五入到指定的精度。

在TIMESTAMP数据类型格式中，精度的最大可能数字是9。
实际支持的数字数由precision参数、配置的默认时间精度和系统能力决定。
如果指定的精度大于配置的默认时间精度，则精度的其他数字将作为尾随零返回。
在POSIXTIME数据类型格式中，精度的最大可能数字为6。
每个POSIXTIME值使用6位精度计算;
除非提供，否则这些小数数字默认为零。
实际支持的非零位数由precision参数、配置的缺省时间精度和系统能力决定。

配置精度

默认精度可以通过以下方式配置:

使用TIME_PRECISION选项设置OPTION。
系统范围的$SYSTEM.SQL.Util.SetOption()方法配置选项DefaultTimePrecision。
要确定当前设置，调用$SYSTEM.SQL.CurrentSettings()，它显示默认的时间精度;
默认值为0。
进入管理门户，选择“系统管理”、“配置”、“SQL和对象设置”、“SQL”。
查看和编辑GETDATE()、CURRENT_TIME和CURRENT_TIMESTAMP的默认时间精度的当前设置。

指定从0到9(包括9)的整数，作为返回的十进制精度的默认位数。
默认值为0。
实际返回的精度取决于平台;
超过系统中可用精度的精度数字将作为零返回。

日期和时间函数比较

GETDATE和NOW也可用于返回当前本地日期和时间，作为TIMESTAMP数据类型或POSIXTIME数据类型值。
GETDATE支持精度，NOW不支持精度。

SYSDATE与CURRENT_TIMESTAMP相同，只是SYSDATE不支持精度。
CURRENT_TIMESTAMP是首选的SQL函数;
提供SYSDATE是为了与其他厂商兼容。

GETUTCDATE可以作为TIMESTAMP数据类型或POSIXTIME数据类型值返回通用的(与时区无关的)日期和时间。
请注意，除了GETUTCDATE之外，所有 SQL时间和日期函数都特定于当地时区设置。
要获得一个通用的(独立于时区的)时间戳，你可以使用GETUTCDATE或者ObjectScript $ZTIMESTAMP特殊变量。

要只返回当前本地日期，请使用CURDATE或CURRENT_DATE。
要只返回当前本地时间，请使用CURRENT_TIME或CURTIME。
这些函数返回DATE或TIME数据类型的值。
这些函数都不支持精度。

TIMESTAMP数据类型的存储格式和显示格式是相同的。
POSIXTIME数据类型存储格式是一个编码的64位有符号整数。
TIME和DATE数据类型将它们的值存储为$HOROLOG格式的整数;
当在SQL中显示时，它们被转换为日期或时间显示格式。
默认情况下，嵌入式SQL以逻辑(存储)格式返回。

可以使用CAST或CONVERT函数来更改日期和时间的数据类型。

示例

下面的例子以三种不同的方式返回当前本地日期和时间:TIMESTAMP数据类型格式，具有系统默认时间精度，具有两位小数秒的精度，以及$HOROLOG内部存储格式，具有全秒:

SELECT 
   CURRENT_TIMESTAMP AS FullSecStamp,
   CURRENT_TIMESTAMP(2) AS FracSecStamp,
   $HOROLOG AS InternalFullSec

下面的嵌入式SQL示例设置了区域设置的缺省时间精度。
第一个CURRENT_TIMESTAMP没有指定精度;
它返回带有默认时间精度的当前时间。
第二个CURRENT_TIMESTAMP指定精度;
这将覆盖配置的缺省时间精度。
precision参数可以大于或小于默认的时间精度设置:

ClassMethod CurrentTimestamp()
{
InitialVal
    s pre = ##class(%SYS.NLS.Format).GetFormatItem("TimePrecision")
ChangeVal
    s x = ##class(%SYS.NLS.Format).SetFormatItem("TimePrecision",4)
    &sql(SELECT CURRENT_TIMESTAMP,CURRENT_TIMESTAMP(2) INTO :a,:b)
    if SQLCODE'=0 {
        w !,"Error code ",SQLCODE }
    else {
    w !,"Timestamp is:  ",a
    w !,"Timestamp is:  ",b }
RestoreVal
    s x = ##class(%SYS.NLS.Format).SetFormatItem("$TimePrecision",pre)
}

DHC-APP>d ##class(PHA.TEST.SQLCommand).CurrentTimestamp()

Timestamp is:  2022-01-25 09:22:49
Timestamp is:  2022-01-25 09:22:49.49

下面的嵌入式SQL示例比较了本地(特定时区)和通用(独立时区)的时间戳:

ClassMethod CurrentTimestamp1()
{
    &sql(SELECT CURRENT_TIMESTAMP,GETUTCDATE() INTO :a,:b)
    IF SQLCODE'=0 {
        w !,"Error code ",SQLCODE }
    ELSE {
        w !,"Local timestamp is:  ",a
        w !,"UTC timestamp is:    ",b
        w !,"$ZTIMESTAMP is:      ",$ZDATETIME($ZTIMESTAMP,3,,3)
 }

DHC-APP>d ##class(PHA.TEST.SQLCommand).CurrentTimestamp1()

Local timestamp is:  2022-01-25 09:23:58
UTC timestamp is:    2022-01-25 01:23:58
$ZTIMESTAMP is:      2022-01-25 01:23:58.568

下面的示例将Orders表中所选行中的LastUpdate字段设置为当前系统日期和时间。
如果LastUpdate是数据类型%TimeStamp, CURRENT_TIMESTAMP将返回当前日期和时间作为ODBC时间戳;
如果LastUpdate是数据类型%PosixTime, CURRENT_TIMESTAMP返回当前日期和时间为编码的64位有符号整数:

UPDATE Orders SET LastUpdate = CURRENT_TIMESTAMP
  WHERE Orders.OrderNumber=:ord

下面的例子创建了一个名为Orders的表，记录收到的产品订单:

CREATE TABLE Orders (
     OrderId     INT NOT NULL,
     ClientId    INT,
     ItemName    CHAR(40) NOT NULL,
     OrderDate   TIMESTAMP DEFAULT CURRENT_TIMESTAMP(3),
     PRIMARY KEY (OrderId))

OrderDate列包含收到订单的日期和时间。
它使用TIMESTAMP数据类型，并使用精度为3的CURRENT_TIMESTAMP函数插入当前系统日期和时间作为默认值。