Convierte una fecha-hora UTC o GMT a una hora local, con la forma de un valor dual.
Sintaxis:
ConvertToLocalTime(timestamp [, place [, ignore_dst=false]])
Tipo de datos que devuelve: dual
| Argumento | Descripción |
|---|---|
| timestamp | La fecha que se ha de evaluar como una indicación de tiempo o una expresión que devuelve una fecha, para convertir, por ejemplo '2012-10-12'. |
| place |
Un lugar o zona horaria de la tabla de lugares y zonas horarias válidos a continuación. Otra posibilidad es usar GMT o UTC para definir la hora local. Son válidos los siguientes valores y rangos de desplazamiento de tiempo.
Nota informativaSi utiliza un desplazamiento de DST (es decir, especifica un valor del argumento ignore_dst que se evalúa como False), debe especificar un lugar, en vez de un desplazamiento de GMT, en el argumento de place. Esto se debe a que el ajuste del horario de verano requiere información latitudinal además de la información longitudinal proporcionada por un desplazamiento GMT. Para obtener información, vea Uso de compensaciones GMT en combinación con DST.
Nota informativaSolo podrá utilizar desplazamientos de tiempo estándar. No es posible utilizar un desplazamiento de tiempo arbitrario, por ejemplo, GMT-04:27.
|
| ignore_dst |
Si este argumento se evalúa como True, DST, (horario de verano) se ignora. Valores de argumento válidos que se evalúan como True incluyen -1 y True(). Si este argumento se evalúa como False, la marca de tiempo se ajusta al horario de verano. Valores de argumento válidos que se evalúan como False incluyen 0 y False(). Si el valor del argumento ignore_dst no es válido, la función evalúa la expresión como si el valor ignore_dst se evaluara como True. Si no se especifica el valor del argumento ignore_dstz , la función evalúa la expresión como si el valor ignore_dst se evaluara como False. |
La hora resultante se ajusta a las configuraciones del horario de verano, a menos que ignore_dst esté configurado como True.
Lugares y zonas horarias
La función ConvertToLocalTime recupera información sobre lugares y zonas horarias de todo el mundo desde el registro de Windows. Esto significa que para que la función opere como es debido, el nombre del lugar que desee utilizar debe coincidir con el correspondiente nombre en el registro de Windows.
El nombre exacto con el que se registra un lugar en el registro de Windows también puede cambiar según la configuración de idioma de su instalación de Windows. Esto se debe a que los nombres de ciertas ciudades y países se escriben de manera diferente en los distintos idiomas.
Hay un listado completo de lugares y zonas horarias del registro de Windows en:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones
De manera alternativa, puede encontrar la lista de zonas horarias y lugares en el Panel de Control de Windows. Abra el Panel de Control, haga clic en la configuración de Fecha y Hora y después en Cambiar Zona Horaria. Puede ver la lista completa de ciudades o países asociados con cada zona horaria en el menú desplegable.
| 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 | - | - | - |
| Ejemplo | Resultado |
|---|---|
|
ConvertToLocalTime('2023-08-14 08:39:47','Paris') |
Devuelve '2023-08-14 10:39:47' y la correspondiente representación interna de fecha-hora. |
| ConvertToLocalTime(UTC(), 'Stockholm') | Devuelve la hora de Estocolmo, ajustándola al horario de verano. |
| ConvertToLocalTime(UTC(), 'Stockholm', -1) | Devuelve la hora de Estocolmo, sin ajuste de horario de verano. |
| ConvertToLocalTime(UTC(), 'GMT-05:00') | Devuelve la hora de la costa este de América del Norte, por ejemplo, Nueva York. No se realiza ningún ajuste para el horario de verano porque se especifica una diferencia GMT, en vez de un lugar. |
| ConvertToLocalTime(UTC(), 'New York', -1) | Devuelve la hora de la costa este de América del Norte (Nueva York), sin ajuste del horario de verano. |
| ConvertToLocalTime(UTC(), 'New York', True()) | Devuelve la hora de la costa este de América del Norte (Nueva York), sin ajuste del horario de verano. |
| ConvertToLocalTime(UTC(), 'New York', 0) | Devuelve la hora de la costa este de América del Norte (Nueva York), ajustándola al horario de verano. |
| ConvertToLocalTime(UTC(), 'New York', False()) | Devuelve la hora de la costa este de América del Norte (Nueva York), ajustándola al horario de verano. |
Uso de compensaciones GMT en combinación con DST
Tras la implementación de las bibliotecas ICU (International Components for Unicode) en QlikView November 2018, el uso de compensaciones del meridiano GMT (Greenwich mean Time) en combinación con el horario de verano DST (Daylight Saving Time) requiere información latitudinal adicional.
GMT es una compensación longitudinal (este-oeste), mientras que DST es una compensación latitudinal (norte-sur). Por ejemplo, Helsinki (Finlandia) y Johannesburgo (Sudáfrica) comparten la misma compensación GMT + 02:00, pero no comparten la misma compensación DST. Esto significa que, además del desplazamiento GMT, cualquier desplazamiento DST requiere información sobre la posición latitudinal de la zona horaria local (entrada de zona horaria geográfica) para tener información completa sobre las condiciones locales de DST.
