SQL函數 UNIX_TIMESTAMP

注:此函數IRIS可用,Cache不可用。

將日期表達式轉換為 UNIX 時間戳的日期/時間函數。

大綱

UNIX_TIMESTAMP([date-expression])

參數

• date-expression - 可選 — 作為列名稱、另一個標量函數的結果或日期或時間戳文字的表達式。 UNIX_TIMESTAMP 不會從一個時區轉換到另一個時區。如果省略 date-expression,則默認為當前 UTC 時間戳。

描述

UNIX_TIMESTAMP 返回一個 UNIX? 時間戳,即自 '1970-01-01 00:00:00'以來的秒數(和小數秒)。

如果不指定 date-expression,則 date-expression 默認為當前 UTC 時間戳。因此,假設系統范圍的默認精度為 3,UNIX_TIMESTAMP() 等效于 UNIX_TIMESTAMP(GETUTCDATE(3))。

如果指定 date-expression,UNIX_TIMESTAMP 會將指定的 date-expression 值轉換為 UNIX 時間戳,計算該時間戳的秒數。 UNIX_TIMESTAMP 可以返回正數或負數秒數。

UNIX_TIMESTAMP 將其值作為數據類型 %Library.Numeric 返回。它可以返回小數秒的精度。如果不指定 date-expression,它將采用當前配置的系統范圍精度。如果指定 date-expression,它將從 date-expression 獲取其精度。

日期表達式值

可選的日期表達式可以指定為:

• ODBC 時間戳值(數據類型 %Library.TimeStamp):YYYY-MM-DD HH:MI:SS.FFF
• PosixTime 時間戳值(數據類型 %Library.PosixTime):編碼的 64 位有符號整數。
• $HOROLOG 日期值(數據類型 %Library.Date):自 1840 年 12 月 31 日以來的天數,其中第 1 天是 1841 年 1 月 1 日。
• $HOROLOG 時間戳,帶或不帶小數秒:64412,54736。

UNIX_TIMESTAMP 不進行時區轉換:如果 date-expression 為 UTC 時間,則返回 UTC UnixTime;如果 date-expression 是本地時間,則返回本地 UnixTime 值。

小數秒精度

小數秒總是被截斷而不是四舍五入到指定的精度。

• %Library.TimeStamp 數據類型格式的日期表達式的最大精度為 9。支持的實際位數由日期表達式精度參數、配置的默認時間精度和系統功能確定。如果指定的精度大于配置的默認時間精度,則精度的附加數字將作為尾隨零返回。
• %Library.PosixTime 數據類型格式的日期表達式的最大精度為六。每個 POSIXTIME 值都是使用六位精度計算的;除非提供,否則這些小數位默認為零。

配置精度

可以使用以下配置默認精度:

• 帶有 TIME_PRECISION 選項的 SET OPTION。
• 系統范圍的 $SYSTEM.SQL.Util.SetOption() 方法配置選項 DefaultTimePrecision。要確定當前設置,請調用顯示默認時間精度的 $SYSTEM.SQL.CurrentSettings();默認值為 0。
• 轉到管理門戶,選擇系統管理、配置、SQL 和對象設置、SQL。查看和編輯 GETDATE()、CURRENT_TIME 和 CURRENT_TIMESTAMP 的默認時間精度的當前設置。

指定一個 0 到 9(含)整數作為要返回的默認精度的小數位數。默認值為 0。返回的實際精度取決于平臺;超過系統上可用精度的精度數字將返回為零。

日期和時間函數比較

UNIX_TIMESTAMP 返回日期和時間,表示為從任意日期經過的秒數。

TO_POSIXTIME 返回一個編碼的 64 位有符號(一個 %PosixTime 時間戳),它是根據 UNIX 時間戳計算的。

GETUTCDATE 以 %TimeStamp(ODBC 時間戳)數據類型或 %PosixTime(編碼的 64 位帶符號整數)數據類型值的形式返回通用(獨立于時區)日期和時間。 %PosixTime 值是根據相應的 UNIX 時間戳值計算得出的。 %PosixTime 編碼有助于快速的時間戳比較和計算。 %Library.PosixTime 類提供 UnixTimeToLogical() 方法將 UNIX 時間戳轉換為 PosixTime 時間戳,并提供 LogicalToUnixTime() 方法將 PosixTime 時間戳轉換為 UNIX 時間戳。這些方法都不執行時區轉換。

還可以使用 ObjectScript $ZTIMESTAMP 特殊變量返回通用(時區無關)時間戳。

ObjectScript $ZDATETIME 函數 dformat -2 采用 $HOROLOG 日期并返回 UNIX 時間戳; $ZDATETIMEH dformat -2 采用 UNIX 時間戳并返回 %HOROLOG日期。這些 ObjectScript 函數將本地時間轉換為 UTC 時間。 UNIX_TIMESTAMP 不會將本地時間轉換為 UTC 時間。

示例

以下示例返回 UTC UNIX 時間戳。第一個選擇項采用日期表達式默認值,第二個指定顯式 UTC 時間戳:

select    UNIX_TIMESTAMP() AS DefaultUTC,   UNIX_TIMESTAMP(GETUTCDATE(3)) AS ExplicitUTC      1652164931  1652164931

以下示例返回當前本地日期和時間的本地 UNIX 時間戳,以及 UTC 日期和時間值的 UTC UNIX 時間戳。第一個選擇項指定本地 CURRENT_TIMESTAMP,第二個指定 $HOROLOG(本地日期和時間),第三個指定當前 UTC 日期和時間:

select    UNIX_TIMESTAMP(CURRENT_TIMESTAMP(2)) AS CurrTSLocal,   UNIX_TIMESTAMP($HOROLOG) AS HorologLocal,   UNIX_TIMESTAMP(GETUTCDATE(3)) AS ExplicitUTC      1652193775  1652193775  1652164975

以下示例比較了 UNIX_TIMESTAMP(不轉換本地時間)和 $ZDATETIME(轉換本地時間):

/// d ##class(PHA.TEST.SQLFunction).UCase()ClassMethod UCase(){    s unixutc = $ZDATETIME($HOROLOG,-2)    s myquery = "select UNIX_TIMESTAMP($HOROLOG) AS UnixLocal,? AS UnixUTC"    s tStatement = ##class(%SQL.Statement).%New()    s qStatus = tStatement.%Prepare(myquery)    s rset = tStatement.%Execute(unixutc)    d rset.%Display()}

DHC-APP>d ##class(PHA.TEST.SQLFunction).UCase()UnixLocal   UnixUTC1652193839  16521650391 Rows(s) Affected