# converttolocaltime Função de script e de gráfico Converte um carimbo de data/hora de UTC ou GMT para a hora local, na forma de um valor duplo. O lugar pode ser qualquer quantidade de cidades, lugares e fusos horários do mundo. Sintaxe: ConvertToLocalTime(timestamp [, place [, ignore\_dst=false]]) Tipo de dados de retorno: dual Argumentos | Argumento | Descrição | | --- | --- | | timestamp | O carimbo de data/hora ou expressão resolvendo para um carimbo de data/hora ser convertido. | | place | Um local ou fuso horário da tabela de locais válidos e fusos horários abaixo. Opcionalmente, você pode usar as opções GMT ou UTC para definir a hora local. Os seguintes valores e intervalos de fuso horário são válidos:



Nota informativaSe você usar um deslocamento de horário de verão (ou seja, especificar um valor de argumento ignore\_dst avaliando como False), deverá especificar um local, em vez de um deslocamento GMT, no argumento place. Isso 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 informações, consulte [Usando deslocamentos GMT em combinação com DST](https://help.qlik.com/pt-BR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm#Using).

Nota informativaVocê pode usar somente fusos horários padrão. Não é possível usar um fuso horário arbitrário como, por exemplo, GMT-04:27. | | ignore\_dst | Se este argumento for avaliado como True, DST (horário de verão) será ignorado. Valores de argumentos válidos avaliados para True 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. Valores de argumentos válidos avaliados para False incluem `0` e `False()`.

Se o valor do argumento ignore\_dst for inválido, a função avaliará a expressão como se o valor ignore\_dst fosse avaliado como True. Se o valor do argumento ignore\_dst não for especificado, a função avaliará a expressão como se o valor ignore\_dst fosse avaliado como False. | Locais e fusos horários válidos | 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 | - | - | - | [](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/DateAndTimeFunctions/converttolocaltime.htm) #### Exemplos e resultados: Exemplos de scripts | Exemplo | Resultado | | --- | --- | | `ConvertToLocalTime('2023-08-14 08:39:47','Paris')` | Retorna '2023-08-14 10:39:47' e a representação do carimbo de data/hora interno correspondente. | | `ConvertToLocalTime(UTC(), 'Stockholm')` | Retorna a hora de Estocolmo, ajustando para o horário de verão. | | `ConvertToLocalTime(UTC(), 'Stockholm', -1)` | Retorna a hora de Estocolmo, sem ajuste do horário de verão. | | `ConvertToLocalTime(UTC(), 'GMT-05:00')` | Retorna a hora da costa leste norte-americana, por exemplo, Nova York. Nenhum ajuste é feito para o horário de verão porque um deslocamento GMT, em vez de um local, é especificado. | | `ConvertToLocalTime(UTC(), 'New York', -1)` | Retorna a hora da costa leste da América do Norte (Nova York), sem ajuste do horário de verão. | | `ConvertToLocalTime(UTC(), 'New York', True())` | Retorna a hora da costa leste da América do Norte (Nova York), sem ajuste do horário de verão. | | `ConvertToLocalTime(UTC(), 'New York', 0)` | Retorna a hora da costa leste da América do Norte (Nova York), ajustando para o horário de verão. | | `ConvertToLocalTime(UTC(), 'New York', False())` | Retorna a hora da costa leste da América do Norte (Nova York), ajustando para o horário de verão. | ## Usando deslocamentos GMT em combinação com DST Após a implementação das bibliotecas de Componentes Internacionais para Unicode (ICU) no Qlik Sense, o uso de deslocamentos GMT (Greenwich Mean Time) em combinação com DST (Daylight Saving Time) requer informações latitudinais adicionais. GMT é um deslocamento longitudinal (leste-oeste), enquanto DST é um deslocamento latitudinal (norte-sul). Por exemplo, Helsinque (Finlândia) e Joanesburgo (África do Sul) compartilham o mesmo deslocamento GMT+02:00, mas não compartilham o mesmo deslocamento DST. Isso significa que, além do deslocamento GMT, qualquer deslocamento DST requer informações sobre a posição latitudinal do fuso horário local (entrada de fuso horário geográfico) para obter informações completas sobre as condições locais do DST.