Provided by:
manpages-es_1.55-10_all 
NOMBRE
tzfile - informacion de huso horario
SINOPSIS
#include <tzfile.h>
DESCRIPCI'ON
Los ficheros de informacion de huso horario usados por tzset(3)
comienzan con la secuencia de caracteres magicos "TZif" para
identificarlos como ficheros de informacion de huso horario, seguidos
por 16 bytes reservados para uso futuro y seguidos por 6 valores de 4
bytes de tipo long, escritos en un orden de bytes ``estandar'' (se
escribe primero el byte de orden superior del valor). Estos valores
son, en orden:
tzh_ttisgmtcnt
El numero de indicadores UTC/local almacenados en el fichero.
tzh_ttisstdcnt
El numero de indicadores estandar/incorporado almacenados en el
fichero.
tzh_leapcnt
El numero de "segundos de salto" para los datos almacenados en
el fichero.
tzh_timecnt
El numero de "instantes de transicion" para los datos
almacenados en el fichero.
tzh_typecnt
El numero de "tipos de hora local" para los datos almacenados en
el fichero (no debe ser cero).
tzh_charcnt
El numero de caracteres de las "cadenas de abreviacion de husos
horarios" almacenadas en el fichero.
A la cabecera anterior le siguen valores tzh_timecnt de cuatro bytes de
tipo long, almacenados en orden ascendente. Estos valores se escriben
en un orden de bytes ``estandar''. Cada uno de ellos se utiliza como
un instante de transicion (tal y como time(2) devuelve las horas) en el
que cambian las reglas para el calculo de la hora local. A
continuacion viene un valor tzh_timecnt de un byte de tipo unsigned
char; cada uno de los cuales indica cual de los diferentes tipos de
``hora local'' descritos en el fichero se asocia con el instante de
transicion colocado en la misma posicion relativa. Estos valores
sirven como indices en un array de estructuras ttinfo que aparecen
despues en el fichero; estas estructuras se definen como sigue:
struct ttinfo {
long tt_gmtoff;
int tt_isdst;
unsigned int tt_abbrind;
};
Cada estructura se escribe como un valor de cuatro byte para tt_gmtoff
de tipo long, en un orden de bytes estandar, seguido por un valor de un
byte para tt_isdst y un valor de un byte para tt_abbrind. En cada
estructura, tt_gmtoff da el numero de segundos a anadir a UTC, tt_isdst
indica si tm_isdst debe ser o no establecido por localtime(3) y
tt_abbrind se utiliza como un indice en el array de caracteres de
abreviacion de huso horario que siguen a la(s) estructura(s) ttinfo en
el fichero.
Despues hay parejas de valores tzh_leapcnt de 4 bytes, escritas en un
orden de bytes estandar; el primer valor de cada pareja indica la hora
(tal y como la devuelve time(2)) a la que se produce un segundo de
salto; el segundo indica el numero total de segundos de salto a aplicar
despues del instante dado. Las parejas de valores se almacenan en
orden ascedente de tiempo.
A continuacion, exiten indicadores estandar/incorporado tzh_ttisstdcnt,
cada uno almacenado como un valor de un byte; indican si los instantes
de transicion asociados con los tipos de hora local se especificaron
como una hora estandar o como una hora del reloj incorporado, y se usan
cuando un fichero de huso horario se usa para manejar variables de
entorno de huso horario al estilo POSIX.
Finalmente, hay indicadores UTC/local tzh_ttisgmtcnt, cada uno
almacenado como un valor de un byte; indican si los instantes de
transicion asociados con los tipos de hora local se especificaron como
horas UTC o locales, y se usan cuando un fichero de huso horario se usa
para manejar variables de entorno de huso horario al estilo POSIX.
Localtime usa la primera estructura ttinfo de hora estandar del fichero
(o, simplemente, la primera estructura ttinfo en ausencia de un
estructura de hora estandar) si o bien tzh_timecnt es cero o bien el
argumento de tiempo es menor que el primer instante de transicion
almacenado en el fichero.
TZFILE(5)