返回日期时间表达式的秒数的时间函数。
{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
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。
本文系转载,前往查看
如有侵权,请联系 cloudcommunity@tencent.com 删除。