第四十五章 Caché 函数大全 $NOW 函数

返回当前日期的本地日期和时间，以小数秒为单位。

大纲

$NOW(tzmins)

参数

tzmins
- 可选—正整数或负整数，以分钟为单位指定距格林威治子午线的期望时区偏移量。值0对应于格林威治子午线。正整数对应于格林威治以西的时区；负整数对应于格林威治东部的时区。例如，值300对应于格林威治以西5小时（300分钟）的美国东部标准时间。允许值的范围是-1440至1440；值超出此范围会导致错误。
- 如果省略tzmins，则$NOW函数将根据$ZTIMEZONE特殊变量值返回本地日期和时间。 $NOW函数支持的$ZTIMEZONE值的范围是-1440至1440；值超出此范围会导致错误。

描述

$NOW可以返回以下内容：

当前本地日期和时间，以秒为单位表示当前进程。
当前进程在指定时区的本地日期和时间，以小数秒为单位。

$NOW函数返回一个字符串，该字符串由两个数值组成，以逗号分隔。第一个数字是代表当前本地日期的整数。第二个是代表当前本地时间的小数。这些值是计数器，而不是用户可读的日期和时间。

$NOW以Caché存储（$HOROLOG）格式返回日期和时间，并带有小数秒的附加功能。 $NOW以以下格式返回当前本地日期和时间：ddddd，sssss.ffffff

第一个整数（ddddd）是自1840年12月31日以来的天数，其中第1天是1841年1月1日。此日期整数的最大值是2980013，对应于9999年12月31日。

第二个数字（ssssss.ffffff）是自当天午夜以来的秒数（以及小数秒）。 Caché将sssss字段从0递增到86399秒。当它在午夜达到86399时，Caché将sssss字段重置为0，并将日期字段递增1。注意，在午夜之后的第一秒内，秒表示为0.ffffff（例如0.123）；此数字不是ObjectScript规范形式（例如.123），这会影响这些值的字符串排序顺序。可以在执行排序操作之前在加号（+）之前强制将数字转换为规范形式。ffffff小数位数是当前操作系统支持的最大精度。

$NOW函数可以在有或没有参数值的情况下调用。括号是必需的。

没有参数值的$NOW返回当前进程的当前本地日期和时间。它根据$ZTIMEZONE特殊变量中设置的值确定本地时区。设置$ZTIMEZONE会更改$NOW的时间部分，并且此时间更改也会更改$NOW的日期部分。

注意

$NOW当地时间值可能与本地时钟时间不对应。 $NOW使用$ZTIMEZONE值确定本地时间。 $ZTIMEZONE全年持续；它不会针对夏令时（DST）或其他当地时间变化进行调整。

使用格林威治子午线的时区计数来计算UTC时间的偏移量。它不是你本地时间与本地格林威治时间的比较。格林威治标准时间（GMT）一词可能令人困惑；格林威治的当地时间与冬季的UTC相同。在夏季，它与UTC相差一小时。这是因为应用了称为英国夏令时的本地时差。 $NOW忽略所有本地时变。

同样，由于$NOW将其时间值与系统时钟重新同步，因此$NOW与其他Caché时间函数和特殊变量之间的时间值比较可能会显示出细微的差异。此变化限制为0.05秒；但是，在此变化范围内，比较可能会产生误导性的结果。例如，WRITE $NOW（），！，$HOROLOG可能会产生如下结果：

61438,38794.002085
61438,38793

此异常是由0.05秒的重新同步变化和分数秒的$HOROLOG截断引起的。

带有参数值的$NOW返回与以tzmins为单位的时区相对应的时间和日期。 $ZTIMEZONE的值将被忽略。

时间函数比较

比较了返回当前日期和时间的各种方法，如下所示：

$NOW返回当前进程的本地日期和时间。 $NOW以Caché存储格式返回日期和时间。它包括小数秒；小数位数是当前操作系统支持的最大精度。
- $NOW（）根据$ZTIMEZONE特殊变量的值确定本地时区。本地时间未针对本地时间变量进行调整，例如夏令时。因此，它可能与本地时钟时间不对应。
- $NOW（tzmins）返回与指定的tzmins时区参数相对应的时间和日期。 $ZTIMEZONE的值将被忽略。
$HOROLOG以Caché存储格式包含经过变量调整的本地日期和时间。本地时区由$ZTIMEZONE特殊变量的当前值确定，然后针对本地时间变量（例如，夏令时）进行调整。它只返回整秒。小数秒被截断。
$ZTIMESTAMP以Caché存储格式包含UTC（世界标准时间）日期和时间（以小数秒为单位）。小数秒以三位精度（在Windows系统上）或六位精度（在UNIX®系统上）表示。因此，$NOW（0）返回的UTC时间的秒精度要比$ZTIMESTAMP高。

这些返回当前日期和时间的方法都不能完全替代过时的$ZUTIL（188）函数，该函数提供了本地日期和时间以及本地时间变体和小数秒的调整。

DHC-APP>w $zutil("188")
65644,81627.106176
DHC-APP>w $now()
65644,81630.608212
DHC-APP>W $H
65644,81633

Windows上的微秒

Windows系统上的微秒精度通常比其他平台的精度低。这是由于QueryPerformanceCounter（）Windows库例程的限制。 Caché通过将QueryPerformanceCounter（）计算的结果与用于其他日期/时间函数的系统时钟进行比较来确定微秒，该时钟的精度最高为1毫秒（根据运行Windows的硬件，精度通常在1到20毫秒之间）。 $NOW微秒精度时钟与毫秒级精度时钟相差超过50毫秒，Caché向前或向后调整微秒级精度时钟，以与精度更高（但精度较低）的毫秒级时钟一致。

因此，在Windows上，$NOW函数（和传统的$ZUTIL（188）函数）仅适用于在很短的持续时间内（不超过几秒钟）测量微秒精度的时间间隔。在具有多个CPU内核的系统上，每个内核的CachéWindows进程将进行微秒调整，该调整仅针对单个进程。这意味着在不同的CachéCPU进程上返回的$NOW值可能彼此不一致。当Windows在多核CPU芯片上托管的虚拟机上运行时，CPU进程之间的差异更加明显。

分隔日期和时间

要仅获取$NOW的日期部分或时间部分，可以使用$PIECE函数，将逗号指定为定界符：

/// d ##class(PHA.TEST.Function).NOW()
ClassMethod NOW()
{
    SET dateval=$PIECE($NOW(),",",1)
    SET timeval=$PIECE($NOW(),",",2)
    WRITE !,"Date and time: ",$NOW()
    WRITE !,"Date only: ",dateval
    WRITE !,"Time only: ",timeval
}

DHC-APP>d ##class(PHA.TEST.Function).NOW()
 
Date and time: 65644,81724.239158
Date only: 65644
Time only: 81724.239154

设定日期

$NOW和$ZTIMESTAMP返回的值不能使用％SYSTEM.Process类的FixedDate（）方法设置。

可以使用％SYSTEM.Process类的FixedDate（）方法将$HOROLOG中包含的值设置为当前过程的用户指定日期。

示例

以下示例显示了两种返回当前本地日期和时间的方法：

DHC-APP> WRITE $ZDATETIME($NOW(),1,1,3)," $NOW() date & time",!
09/22/2020 22:43:22.565 $NOW() date & time
 
DHC-APP>WRITE $ZDATETIME($HOROLOG,1,1,3)," $HOROLOG date & time"
09/22/2020 22:43:28.000 $HOROLOG date & time

DHC-APP>WRITE $ZDATETIME($HOROLOG,3,1,6)
2020-09-22 22:44:47.000000

DHC-APP>WRITE $ZDATETIME($now(),3,1,6)
2020-09-22 22:44:58.894816

请注意，$HOROLOG会针对本地时间变量进行调整，例如夏令时。 $NOW不会针对当地时间变化进行调整。

下面的示例使用$ZDATE将$NOW中的日期字段转换为日期格式。

DHC-APP> WRITE $ZDATE($PIECE($NOW(),",",1))
09/22/2020

下面的示例将$NOW的时间部分转换为12小时（上午或下午）时钟的小时：分钟：秒.ffff形式的时间。

/// d ##class(PHA.TEST.Function).NOW1()
ClassMethod NOW1()
{
   
    NEW
    SET Time = $PIECE($NOW(),",",2)
    SET Sec = Time # 60
    SET Totmin = Time \ 60
    SET Min = Totmin # 60
    SET Milhour = Totmin \ 60
    IF (Milhour = 12) { 
        SET Hour = 12,Meridian = " pm" 
    } ELSEIF (Milhour > 12) { 
        SET Hour = Milhour-12, Meridian=" pm" 
    } ELSE { 
        SET Hour = Milhour, Meridian=" am" 
    }
    WRITE !,Hour,":",Min,":",Sec,Meridian
    QUIT
}

DHC-APP>d ##class(PHA.TEST.Function).NOW1()
 
10:48:38.77612 pm