converttolocaltime - 指令碼與圖表函數
將 UTC 或 GMT 時間戳記轉換為當地時間作為雙值。
語法:
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
傳回資料類型:雙值
引數:
引數 | 描述 |
---|---|
timestamp | 要轉換的時間戳記或解析為時間戳記的運算式的日期,例如 '2012-10-12'。 |
place |
下方地點及時區表格中的地點或時區。或者,您可以使用 GMT 或 UTC 來定義當地時間。下列值及時間偏移範圍有效:
資訊備註您只能使用標準時間偏移。不能使用任意的時間偏移,例如,GMT-04:27。
|
ignore_dst | 如果您想要忽略 DST (日光節約時間),設為 True。 |
產生的時間會根據日光節約時間進行調整,除非 ignore_dst 設為 True。
地點和時區
ConvertToLocalTime 函數可從 Windows 登錄擷取世界各地的地點和時區資訊。這代表要讓函數運作,您想要使用的地點名稱必須符合 Windows 登錄中的對應名稱。
地點在 Windows 登錄中所登錄的確切名稱也會根據 Windows 安裝的語言設定而變更。這是因為某些城市和國家的名稱,在不同的語言中會有不同的拼寫方式。
此處有 Windows 登錄中的完整地點和時區清單:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
或者,您可以在 Windows 控制台找到時區和地點清單。開啟控制台、按一下日期和時間設定,然後變更時區。您可以從下拉式功能表看見與每個時區有關的完整城市或國家清單。
範例與結果:
範例 | 結果 |
---|---|
ConvertToLocalTime('2007-11-10 23:59:00','Paris') | 傳回 '2007-11-11 00:59:00' 及對應的內部時間戳記表示法。 |
ConvertToLocalTime(UTC(), 'GMT-05:00') | 傳回北美東岸 (例如紐約) 的時間。 |
ConvertToLocalTime(UTC(), 'GMT-05:00', True) | 傳回北美東岸 (例如紐約) 的時間,無日光節約時間調整。 |
結合 DST 使用 GMT 時區
在 2018 年 11 月於 QlikView 實施 Unicode 程式庫的國際元件 (ICU) 後,結合 DST (日光節約時間) 使用 GMT (格林威治平均時間) 時區需要其他緯度資訊。
GMT 是經度 (東西向) 時區,而 DST 則是緯度 (南北向) 時區。例如,赫爾辛基 (芬蘭) 和約翰尼斯堡 (南非) 共用相同的 GMT+02:00 時區,但沒有共用相同的 DST 時區。這表示,除了 GMT 時區,任何 DST 時區還需要當地時區的緯度位置資訊 (地理時區輸入),才能具有關於當地 DST 條件的完整資訊。