# localtime - 脚本和图表函数

此函数用于返回指定时区的系统时钟的当前时间戳。

语法：

LocalTime([timezone [, ignoreDST ]])

**返回数据类型：** 双

LocalTime 参数

| 参数 | 说明 |
| --- | --- |
| timezone | 该 timezone 被指定为一个字符串，其包含 Windows 控制面板时区下专为日期和时间列出的任何一个地理位置，或指定为以“GMT+hh:mm”字符串。下表还列出了可接受的地点和时区列表。<br><br>如果未指定时区，则返回本地时间。<br><br>信息注释如果使用 DST 偏移量（即，指定 ignoreDST 参数值，其计算为 False），则必须在 place 参数中指定一个位置，而不是 GMT 偏移量。这是因为调整夏令时除了需要由 GMT 偏移提供的经度信息外，还需要纬度信息。更多信息，请参阅[将 GMT 偏移量与夏令时结合使用](https://help.qlik.com/zh-CN/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/DateAndTimeFunctions/localtime.htm#Using)。 |
| ignoreDST | 如果此参数的计算结果为 True，则忽略 DST（夏令时）。有效的参数值计算包括 `-1` 和 `True()`。<br><br>如果此参数的计算结果为 False，则会根据夏令时调整时间戳。有效的参数值计算包括 `0` 和 `False()`。<br><br>如果 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。同时 |

## 将 GMT 偏移量与夏令时结合使用

在 QlikView November 2018 中实施国际 Unicode 组件 (ICU) 库之后，如要将 GMT（格林尼治标准时间）偏移与 DST（夏令时）结合使用，则需要额外的纬度信息。

GMT 是经度（东西）偏移，而 DST 是纬度（南北）偏移。例如，赫尔辛基（芬兰）和约翰内斯堡（南非）共享相同的 GMT+02:00 偏移量，但它们不共享相同的 DST 偏移量。这意味着，除了 GMT 偏移之外，任何夏令时偏移都需要关于当地时区的纬度位置的信息（地理时区输入），以便获得关于当地夏令时条件的完整信息。