localtime - 脚本和图表函数
此函数用于返回指定时区的当前时间戳。
语法:
LocalTime([timezone [, ignoreDST ]])
返回数据类型: 双
参数 | 说明 |
---|---|
timezone |
将 timezone 指定为一个字符串,其中包含在 Windows 控制面板的时区下专为日期和时间列出的任何一个地理位置,或指定为“GMT+hh:mm”格式的字符串。下表还列出了可接受的地点和时区列表。 如果未指定时区,则返回本地时间。 信息注释如果使用 DST 偏移量(即,指定的 ignoreDST 参数值计算为 False),则必须在 place 参数中指定一个位置,而不是 GMT 偏移量。这是因为调整夏令时除了需要 GMT 偏移量提供的纵向信息外,还需要纬度信息。有关更多信息,请参阅将 GMT 偏移量与夏令时结合使用。
|
ignoreDST |
如果此参数计算为 True,则忽略 DST(夏令时)。有效的参数值计算为 True,包括 -1 和 True()。 如果此参数计算为 False,则会根据夏令时调整时间戳。有效的参数值计算为 False,包括 0 和 False()。 如果 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,考虑夏令时。 |
将 GMT 偏移量与夏令时结合使用
在 Qlik Sense 实施 Unicode (ICU) 库的国际组件之后,将 GMT(格林尼治标准时间)偏移量与 DST(夏令时)结合使用需要额外的纬度信息。
GMT 是纵向(东西)偏移,而夏令时是横向(南北)偏移。例如,赫尔辛基(芬兰)和约翰内斯堡(南非)共享相同的 GMT+02:00 偏移量,但它们不共享相同的夏令时偏移量。这意味着,除了 GMT 偏移之外,任何夏令时偏移都需要关于当地时区的纬度位置的信息(地理时区输入),以便获得关于当地夏令时条件的完整信息。