Zona horaria y parámetro "Z"

Información

El parámetro "Z" y la información de zona horaria solo se utilizan en la API XML al exportar en formato CSV. Esto solo afecta a los valores de fecha y hora descriptivos en las exportaciones CSV. No afecta al devolver datos en formato XML ni a los parámetros de entrada relacionados con la hora.
A partir de la versión 1.2 del firmware, si se omite el valor del parámetro "Z", la salida CSV utilizará la zona horaria configurada localmente para los valores de fecha y hora CSV de fácil lectura (configurados en Ajustes -> Fecha y hora). Para que esto funcione, se debe pasar el parámetro "Z", pero con un valor vacío (p. ej., egauge-show?n=60&m&c&Z= ).

Al usar la API XML para solicitar datos en formato CSV, el parámetro de cadena de consulta "Z" se utiliza para especificar una zona horaria para formatear la columna de fecha y hora en la salida CSV. Si se omite este parámetro por completo, la columna de fecha y hora mostrará marcas de tiempo Unix. Si se proporciona un valor no válido, la fecha y hora se mostrarán en formato UTC en un formato accesible para usuarios.

El formato de esta cadena se describe en la variable de entorno TZ en https://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html . Al final de esta página encontrará ejemplos de cómo decodificar y escribir zonas horarias personalizadas.

Zonas horarias comunes

EE. UU./Este	LST5LDT4,M3.2.0/02:00,M11.1.0/02:00
EE. UU./Central	LST6LDT5,M3.2.0/02:00,M11.1.0/02:00
EE. UU./Montaña	LST7LDT6,M3.2.0/02:00,M11.1.0/02:00
Estados Unidos/Arizona	LST7
EE. UU./Pacífico	LST8LDT7,M3.2.0/02:00,M11.1.0/02:00
Estados Unidos/Alaska	LST9LDT8,M3.2.0/02:00,M11.1.0/02:00
Estados Unidos/Hawái	LST10
Estados Unidos/Isla Baker	LST-12
Estados Unidos/Samoa	LST11
Australia/Central	LST-10:30
Australia/Este	LST-10LDT-11,M10.1.0/02:00,M4.1.0/03:00
Australia/Norfolk	LST-12:30
Islas Azores	LST1LDT0,M3.5.6/24:00,M10.5.0/01:00
Brasil	LST3LDT2,M10.3.6/24:00,M2.5.6/24:00
Canadá/Atlántico	LST4LDT3,M3.2.0/02:00,M11.1.0/02:00
China/Pekín	LST-8
Europa/Central	LST-1LDT-2,M3.5.0/02:00,M10.5.0/03:00
Europa/Oriental	LST-2LDT-3,M3.5.0/03:00,M10.5.0/04:00
Europa/Occidental	LST0LDT-1,M3.5.0/01:00,M10.5.0/02:00
India	LST-6:30
Irán	LST-4:30LDT-5:30,M3.3.2/24:00,M9.3.4/24:00
Irak/Bagdad	LST-3
Kazajstán/Astana	LST-6
Nueva Zelanda	LST-12LDT-13,M9.5.0/02:00,M4.1.0/03:00
Pakistán/Karachi	LST-5
Rusia/Moscú	LST-4
Rusia/Vladivostok	LST-11
Sándwich del Sur	LST2
Tailandia/Bangkok	LST-7
Tokio	LST-9

Decodificación y comprensión de cadenas de zonas horarias

En las cadenas de zona horaria, "LST" y "DST" significan "Hora estándar local" y "Hora estándar de verano", respectivamente.

Para obtener una descripción completa del formato de la cadena de zona horaria, consulte la variable de entorno TZ en https://pubs.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html .

La cadena generalmente se divide en tres secciones separadas por comas. La primera sección describe la diferencia entre la hora UTC y la hora local. La segunda sección describe cuándo comienza el horario de verano y la tercera sección describe cuándo termina.

Las secciones que describen cuándo comienza y termina el horario de verano tienen el siguiente formato:

Mm.nd/t

El día d (0 <= d <= 6) de la semana n del mes m del año (1 <= n <= 5, 1 <= m <= 12, donde semana 5 significa "el último día d del mes m", que puede ocurrir en la cuarta o quinta semana). La semana 1 es la primera semana en la que ocurre el día d. El día cero es domingo. t es el horario de 24 horas en el que ocurre. Si se omite, el valor predeterminado es las 2:00 a. m.

EE. UU./Este

Cadena de zona horaria: LST5LDT4,M3.2.0/02:00,M11.1.0/02:00

Cada sección, separada por comas, se describe así:

LST5LDT4 UTC es 5 horas después de la hora estándar local ( LST5 ), y UTC es 4 horas después del horario de verano ( LDT4 ).
M3.2.0/02:00 El horario de verano comienza en marzo ( 3 ) en la segunda semana ( 2 ) el domingo ( 0 ) a las 2:00 a. m. ( 2:00 )
M11.1.0/02:00 El horario de verano termina en noviembre ( 11 ) en la primera semana ( 1 ) el domingo ( 0 ) a las 2:00 a. m. ( 2:00 )

Estados Unidos/Hawái

Cadena de zona horaria: LST10

El UTC es 10 horas posterior a la hora local de Hawái. No se observa el horario de verano, por lo que no hay una definición de LDT ni secciones adicionales.

Nueva Zelanda

Cadena de zona horaria: LST-12LDT-13,M9.5.0/02:00,M4.1.0/03:00