# localtime - 指令碼與圖表函數

此函數會傳回指定時區目前時間的時間戳記。

語法：

LocalTime([timezone [, ignoreDST ]])

傳回的資料類型： 雙值

引數

| 引數 | 描述 |
| --- | --- |
| timezone | timezone 指定為字串，包含 Windows Control Panel 中為 Date and Time 列出的 Time Zone 下列出的任何地理位置，或者指定為 'GMT+hh:mm' 格式的字串。下表也呈現了接受的地點和時區清單。<br><br>如未指定時區，則會傳回當地時間。<br><br>資訊備註若您使用 DST 時差 (亦即您指定評估為 False 的 ignoreDST 引數值)，您必須在 place 引數中指定一個地方，而非 GMT 時差。這是因為對日光節約時間進行調整時，除了 GMT 時差提供的經度資訊，還需要緯度資訊。如需詳細資訊，請參閱[結合 DST 使用 GMT 時差](https://help.qlik.com/zh-TW/sense/November2025/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/localtime.htm#Using)。 |
| ignoreDST | 若此引數評估為 True，會忽略 DST (日光節約時間)。評估為 True 的有效引數值包括 `-1` 和 `True()`。<br><br>若此引數評估為 False，會為日光節約時間調整時間戳記。評估為 False 的有效引數值包括 `0` 和 `False()`。<br><br>若 ignoreDST 引數值無效，該函數會按照 ignore\_dst 值評估為 True 的情境來評估運算式。若未指定 ignoreDST 引數值，該函數會按照 ignore\_dst 值評估為 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 時差

按照 Qlik Sense 中國際統一碼元件 (ICU) 庫的實施，結合 DST (日光節約時間) 使用 GMT (格林威治標準時間) 時差需要附加的緯度資訊。

GMT 是經度 (東西向) 時差，而 DST 則是緯度 (南北向) 時差。例如，赫爾辛基 (芬蘭) 和約翰尼斯堡 (南非) 共用相同的 GMT+02:00 時差，但沒有共用相同的 DST 時差。這表示，除了 GMT 時差，任何 DST 時差都需要當地時區的緯度位置資訊 (地理時區輸入)，才能有完整的當地 DST 條件資訊。