localtime - 指令碼與圖表函數
此函數會為指定時區傳回系統時鐘目前時間的時間戳記。
語法:
LocalTime([timezone [, ignoreDST ]])
傳回資料類型: 雙值
引數 | 描述 |
---|---|
timezone |
timezone 指定為字串,包含 Windows 控制面板中為日期和時間列出的時區下列出的任何地理位置,或者指定為 'GMT+hh:mm' 格式的字串。接受的地點和時區清單也呈現於下表。 如未指定時區,則會傳回當地時間。 資訊備註若您使用 DST 偏移 (亦即您指定評估為 False 的 ignoreDST 引數值),您必須在 place 引數中指定地點,而非 GMT 偏移。這是因為除了 GMT 偏移提供的經度資訊,為日光節約時間進行調整也需要緯度資訊。如需詳細資訊,請參閱 結合 DST 使用 GMT 偏移。
|
ignoreDST |
若此引數評估為 True,會忽略 DST (日光節約時間)。有效引數值包括 -1 和 True()。 若此引數評估為 False,會為日光節約時間調整時間戳記。有效引數值包括 0 和 False()。 若 ignoreDST 引數值無效,則函數評估運算式的方式,如同 ignoreDST 值評估為 True (忽略日光節約時間)。若未指定 ignoreDST 引數值,則函數評估運算式的方式,如同 ignoreDST 值評估為 False (為日光節約時間調整時間戳記)。 |
A-C | D-K | L-R | S-Z |
---|---|---|---|
Abu Dhabi | Darwin | La Paz | Samoa |
Adelaide | Dhaka | Lima | Santiago |
Alaska | Eastern Time (US & Canada) | Lisbon | Sapporo |
Amsterdam | Edinburgh | Ljubljana | Sarajevo |
Arizona | Ekaterinburg | London | Saskatchewan |
Astana | Fiji | Madrid | Seoul |
Athens | Georgetown | Magadan | Singapore |
Atlantic Time (Canada) | Greenland | Mazatlan | Skopje |
Auckland | Greenwich Mean Time : Dublin | Melbourne | Sofia |
Azores | Guadalajara | Mexico City | Solomon Is. |
Baghdad | Guam | Mid-Atlantic | Sri Jayawardenepura |
Baku | Hanoi | Minsk | St. Petersburg |
Bangkok | Harare | Monrovia | Stockholm |
Beijing | Hawaii | Monterrey | Sydney |
Belgrade | Helsinki | Moscow | Taipei |
Berlin | Hobart | Mountain Time (US & Canada) | Tallinn |
Bern | Hong Kong | Mumbai | Tashkent |
Bogota | Indiana (East) | Muscat | Tbilisi |
Brasilia | International Date Line West | Nairobi | Tehran |
Bratislava | Irkutsk | New Caledonia | Tokyo |
Brisbane | Islamabad | New Delhi | Urumqi |
Brussels | Istanbul | Newfoundland | Warsaw |
Bucharest | Jakarta | Novosibirsk | Wellington |
Budapest | Jerusalem | Nuku'alofa | West Central Africa |
Buenos Aires | Kabul | Osaka | Vienna |
Cairo | Kamchatka | Pacific Time (US & Canada) | Vilnius |
Canberra | Karachi | Paris | Vladivostok |
Cape Verde Is. | Kathmandu | Perth | Volgograd |
Caracas | Kolkata | Port Moresby | Yakutsk |
Casablanca | Krasnoyarsk | Prague | Yerevan |
Central America | Kuala Lumpur | Pretoria | Zagreb |
Central Time (US & Canada) | Kuwait | Quito | - |
Chennai | Kyiv | Riga | - |
Chihuahua | - | Riyadh | - |
Chongqing | - | Rome | - |
Copenhagen | - | - | - |
範例與結果:
以下範例根據在當地時間 2023-08-14 08:39:47 呼叫的函數,而伺服器或桌面環境的當地時區是 GMT-05:00,並位於自此列出日期起已實施日光節約時間的地區。
範例 | 結果 |
---|---|
localtime () |
傳回當地時間 2023-08-14 08:39:47。 |
localtime ('London') |
傳回倫敦當地時間 2023-08-14 13:39:47。 |
localtime ('GMT+02:00') |
傳回時區 GMT+02:00 的當地時間 2023-08-14 14:39:47。沒有為日光節約時間進行調整,因為指定了 GMT 偏移,而非地點。 |
localtime ('Paris',-1) |
傳回巴黎當地時間 (忽略日光節約時間) 2023-08-14 13:39:47。 |
localtime ('Paris',True()) |
傳回巴黎當地時間 (忽略日光節約時間) 2023-08-14 13:39:47。 |
localtime ('Paris',0) |
傳回巴黎當地時間 (考量日光節約時間) 2023-08-14 14:39:47。 |
localtime ('Paris',False()) |
傳回巴黎當地時間 (考量日光節約時間) 2023-08-14 14:39:47。 |
結合 DST 使用 GMT 偏移
在 QlikView November 2018 實施國際 Unicode 元件 (ICU) 庫後,使用 GMT (格林威治標準時間) 偏移結合 DST (日光節約時間) 還需要緯度資訊。
GMT 是經度 (東西向) 偏移,而 DST 則是緯度 (南北向) 偏移。例如,赫爾辛基 (芬蘭) 和約翰尼斯堡 (南非) 共用相同的 GMT+02:00 偏移,但沒有共用相同的 DST 偏移。這表示,除了 GMT 偏移,任何 DST 偏移都需要當地時區的緯度位置資訊 (地理時區輸入),才能有關於當地 DST 條件的完整資訊。