第124章 SQL函数 SECOND
返回日期时间表达式的秒数的时间函数。
大纲
{fn SECOND(time-expression)}
参数
time-expression- 作为列名、另一个标量函数的结果或字符串或数字文字的表达式。它必须解析为时间戳字符串或$HOROLOG字符串，其中基础数据类型可以表示为%Time、%TimeStamp或%PosixTime。
描述
SECOND 返回一个从 0 到 59 的整数，也可能返回小数秒。秒数是针对 $HOROLOG 或 $ZTIMESTAMP 值、ODBC 格式日期字符串（没有时间值）或时间戳计算的。
时间表达式时间戳可以是数据类型 %Library.PosixTime（编码的 64 位有符号整数），也可以是数据类型 %Library.TimeStamp (yyyy-mm-dd hh:mm:ss.fff)。
要更改默认时间格式，请使用 SET OPTION 命令。
必须提供时间戳字符串 (yyyy-mm-dd hh:mm:ss) 或 $HOROLOG 字符串。 $HOROLOG 字符串可以是完整的日期时间字符串 (63274,37279) 或只是 $HOROLOG (37279) 的时间整数部分。不能提供时间字符串 (hh:mm:ss)；无论实际秒数如何，这始终返回 0。
日期时间字符串的时间部分必须是有效时间。否则，将生成 SQLCODE -400错误 <ILLEGAL VALUE>。秒 (ss) 部分必须是 0 到 59 范围内的整数。前导零在输入时是可选的；前导零在输出上被抑制。
日期时间字符串的日期部分未经过验证。
当秒部分为“0”或“00”时，SECOND 返回 0 秒。如果提供了没有时间表达式的 ODBC 日期，或者完全省略了时间表达式的秒部分('hh', 'hh:mm', 'hh:mm:', or 'hh::')。
可以使用 DATEPART 或 DATENAME 返回相同的时间信息。
也可以使用 SECOND() 方法调用从 ObjectScript 调用此函数：
$SYSTEM.SQL.Functions.SECOND(time-expression)
小数秒
如果在 time-expression 中提供 SECOND，则返回秒的小数部分。尾随零被截断。如果未指定小数秒（例如：38.00），则小数分隔符也会被截断。
时间值的标准内部表示 ($HOROLOG) 不支持小数秒。时间戳确实支持小数秒。
以下 SQL 函数支持小数秒：SECOND、CURRENT_TIMESTAMP、DATENAME、DATEPART 和 GETDATE。 CURTIME、CURRENT_TIME 和 NOW 不支持小数秒。
SQL SET OPTION 语句允许设置小数秒的默认精度（小数位数）。
ObjectScript $ZTIMESTAMP 特殊变量可用于表示小数秒。 ObjectScript 函数 $ZDATETIME、$ZDATETIMEH、$ZTIME 和 $ZTIMEH 支持小数秒。
示例
以下示例都返回数字 38，因为它是时间表达式的 38 秒：
SELECT {fn SECOND('2018-02-16 18:45:38')} AS ODBCSeconds
38
SELECT {fn SECOND(67538)} AS HorologSeconds
38
以下示例返回 0.9 秒。前导零和尾随零被截断：
SELECT {fn SECOND('2018-02-16 18:45:00.9000')} AS Seconds_Given
0
以下示例返回 0 秒，因为省略了日期时间字符串的秒部分：
SELECT {fn SECOND('2018-02-16 18:45')} AS Seconds_Given
0
以下示例返回 0 秒，因为日期时间字符串中省略了时间表达式：
SELECT {fn SECOND('2018-02-16')} AS Seconds_Given
0
以下示例均返回当前时间的秒部分，以整秒为单位：
SELECT {fn SECOND(CURRENT_TIME)} AS Sec_CurrentT,
{fn SECOND({fn CURTIME()})} AS Sec_CurT,
{fn SECOND({fn NOW()})} AS Sec_Now,
{fn SECOND($HOROLOG)} AS Sec_Horolog,
{fn SECOND($ZTIMESTAMP)} AS Sec_ZTS
40 40 40 40 40
以下示例显示前导零被抑制。第一个 SECOND 函数返回长度为 2，其他函数返回长度为 1。省略的时间被认为是 0 秒，其长度为 1：
SELECT LENGTH({fn SECOND('2018-02-15 11:45:22')}),
LENGTH({fn SECOND('2018-02-15 03:05:06')}),
LENGTH({fn SECOND('2018-02-15 3:5:6')}),
LENGTH({fn SECOND('2018-02-15')})
2 1 1 1
以下嵌入式 SQL 示例显示 SECOND 函数识别为区域设置指定的 TimeSeparator 字符：
/// d ##class(PHA.TEST.SQLFunction).Second()
ClassMethod Second()
{
d ##class(%SYS.NLS.Format).SetFormatItem("TimeSeparator",".")
&sql(
SELECT {fn SECOND('2018-02-16 18.45.38')} INTO :a
)
w "seconds=",a
}
DHC-APP>d ##class(PHA.TEST.SQLFunction).Second()
seconds=38
