NOMBRE

       tzfile - información de huso horario

SINOPSIS

       #include <tzfile.h>

DESCRIPCIÓN

       Los ficheros de información de huso horario usados por tzset(3) comienzan con la secuencia
       de caracteres mágicos "TZif" para identificarlos como  ficheros  de  información  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 ``estándar'' (se escribe primero el byte
       de orden superior del valor).  Estos valores son, en orden:

       tzh_ttisgmtcnt
              El número de indicadores UTC/local almacenados en el fichero.

       tzh_ttisstdcnt
              El número de indicadores estándar/incorporado almacenados en el fichero.

       tzh_leapcnt
              El número de "segundos de salto" para los datos almacenados en el fichero.

       tzh_timecnt
              El número de "instantes de transición" para los datos almacenados en el fichero.

       tzh_typecnt
              El  número  de  "tipos  de hora local" para los datos almacenados en el fichero (no
              debe ser cero).

       tzh_charcnt
              El número  de  caracteres  de  las  "cadenas  de  abreviación  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
       ``estándar''.   Cada  uno  de  ellos se utiliza como un instante de transición (tal y como
       time(2) devuelve las horas) en el que cambian las reglas para el cálculo de la hora local.
       A  continuación  viene  un valor tzh_timecnt de un byte de tipo unsigned char; cada uno de
       los cuales indica cuál de los diferentes tipos de ``hora local'' descritos en  el  fichero
       se  asocia  con  el  instante de transición colocado en la misma posición relativa.  Estos
       valores sirven como índices en un array de estructuras ttinfo que aparecen después  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 estándar, 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 número de segundos a añadir a
       UTC, tt_isdst indica si tm_isdst debe ser o no establecido por localtime(3)  y  tt_abbrind
       se  utiliza  como  un  índice en el array de caracteres de abreviación de huso horario que
       siguen a la(s) estructura(s) ttinfo en el fichero.

       Después hay parejas de valores tzh_leapcnt de 4 bytes,  escritas  en  un  orden  de  bytes
       estándar; 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 número total  de  segundos  de
       salto  a  aplicar después del instante dado.  Las parejas de valores se almacenan en orden
       ascedente de tiempo.

       A  continuación,  exiten  indicadores  estándar/incorporado   tzh_ttisstdcnt,   cada   uno
       almacenado  como un valor de un byte; indican si los instantes de transición asociados con
       los tipos de hora local se especificaron como una hora estándar 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 transición 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 estándar del fichero (o, simplemente,
       la primera estructura ttinfo en ausencia de un estructura de  hora  estándar)  si  o  bien
       tzh_timecnt  es  cero  o  bien  el  argumento de tiempo es menor que el primer instante de
       transición almacenado en el fichero.

                                                                                        TZFILE(5)