Esta função retorna um carimbo de hora da hora atual do relógio do sistema para um determinado fuso horário.
Sintaxe:
LocalTime([timezone [, ignoreDST ]])
Tipo de dados de retorno: dual
| Argumento | Descrição |
|---|---|
| timezone |
A timezone é especificada como uma sequência que contém qualquer um dos locais geográficos listados em Fuso horário no Painel de controle do Windows para Data e hora ou como uma sequência no formato 'GMT+hh:mm'. Uma lista de locais e fusos horários aceitos também é apresentada na tabela abaixo. Se nenhum fuso horário for especificado, será retornada a hora local. Nota informativaSe você usar um deslocamento de horário de verão (ou seja, especificar um valor de argumento ignoreDST avaliado como False), deverá especificar um local, em vez de um deslocamento GMT, no argumento place. Isto ocorre porque o ajuste para o horário de verão requer informações latitudinais além das informações longitudinais fornecidas por um deslocamento GMT. Para obter mais informações, consulte Usando deslocamentos GMT em combinação com DST.
|
| ignoreDST |
Se este argumento for avaliado como True, DST (horário de verão) será ignorado. Os valores de argumentos válidos incluem -1 e True(). Se esse argumento for avaliado como False, o carimbo de data/hora será ajustado para o horário de verão. Os valores de argumentos válidos incluem 0 e False(). Se o valor do argumento ignoreDST for inválido, a função avaliará a expressão como se o valor de ignoreDST fosse avaliado como True (o horário de verão será ignorado). Se o valor do argumento ignoreDST não for especificado, a função avaliará a expressão como se o valor ignoreDST fosse avaliado como False (o carimbo de data/hora será ajustado para o horário de verão). |
| 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 | - | - | - |
Exemplos e resultados:
Os exemplos abaixo são baseados na função chamada em 14/08/2023 08:39:47, horário local, com o fuso horário local do servidor ou ambiente de desktop sendo GMT-05:00 e em uma região que implementou o horário de verão economizando tempo a partir desta data listada.
| Exemplo | Resultado |
|---|---|
|
localtime () |
Retorna a hora local 2023-08-14 08:39:47. |
|
localtime ('London') |
Retorna a hora local em Londres, 14/08/2023 13:39:47. |
|
localtime ('GMT+02:00') |
Retorna a hora local no fuso horário GMT+02:00, 2023-08-14 14:39:47. Nenhum ajuste é feito para o horário de verão porque é especificado um deslocamento GMT, em vez de um local. |
|
localtime ('Paris',-1) |
Retorna a hora local de Paris com o horário de verão ignorado, 2023-08-14 13:39:47. |
|
localtime ('Paris',True()) |
Retorna a hora local de Paris com o horário de verão ignorado, 2023-08-14 13:39:47. |
|
localtime ('Paris',0) |
Retorna a hora local de Paris, levando em consideração o horário de verão, 2023-08-14 14:39:47. |
|
localtime ('Paris',False()) |
Retorna a hora local de Paris, levando em consideração o horário de verão, 2023-08-14 14:39:47. |
Usando deslocamentos GMT em combinação com DST
Após a implementação de bibliotecas de Componentes Internacionais para Unicode (ICU) no QlikView November 2018, o uso de compensações GMT (Horário de Greenwich) em combinação com DST (Horário de Verão) requer informações latitudinais adicionais.
GMT é um deslocamento longitudinal (leste-oeste), enquanto DST é um deslocamento latitudinal (norte-sul). Por exemplo, Helsínquia (Finlândia) e Joanesburgo (África do Sul) partilham o mesmo deslocamento GMT+02:00, mas não partilham o mesmo deslocamento do horário de verão. Isso significa que, além do deslocamento GMT, qualquer deslocamento do horário de verão requer informações sobre a posição latitudinal do fuso horário local (entrada do fuso horário geográfico) para ter informações completas sobre as condições locais do horário de verão.
