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

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

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

大纲

$NOW(tzmins)


参数

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

描述

$NOW可以返回以下内容&＃xff1a;

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

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

$NOW以Caché存储&＃xff08;$HOROLOG&＃xff09;格式返回日期和时间&＃xff0c;并带有小数秒的附加功能。 $NOW以以下格式返回当前本地日期和时间&＃xff1a;ddddd&＃xff0c;sssss.ffffff

第一个整数&＃xff08;ddddd&＃xff09;是自1840年12月31日以来的天数&＃xff0c;其中第1天是1841年1月1日。此日期整数的最大值是2980013&＃xff0c;对应于9999年12月31日。

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

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

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

注意

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

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

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

61438,38794.002085
61438,38793


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

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

时间函数比较

比较了返回当前日期和时间的各种方法&＃xff0c;如下所示&＃xff1a;

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

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

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


Windows上的微秒

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

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

分隔日期和时间

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

/// d ##class(PHA.TEST.Function).NOW()
ClassMethod NOW()
{
SET dateval&＃61;$PIECE($NOW(),",",1)
SET timeval&＃61;$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返回的值不能使用&＃xff05;SYSTEM.Process类的FixedDate&＃xff08;&＃xff09;方法设置。

可以使用&＃xff05;SYSTEM.Process类的FixedDate&＃xff08;&＃xff09;方法将$HOROLOG中包含的值设置为当前过程的用户指定日期。

示例

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

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


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

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

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


下面的示例将$NOW的时间部分转换为12小时&＃xff08;上午或下午&＃xff09;时钟的小时&＃xff1a;分钟&＃xff1a;秒.ffff形式的时间。

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


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