.\" -*- nroff -*-
.TH TZFILE 5
.SH NOME
tzfile \- informação de fuso horário
.SH SINOPSE
.B
#include <tzfile.h>
.SH DESCRIÇÃO
O arquivo de informações sobre fusos horário usado por
.IR tzset (3)
inicia com o caracter mágico "TZif" para identificar na mesma hora
como arquivos de informações sobre fusos horário, seguido por dezesseis
bytes reservados para uso futuro, seguido por seis valores de quatro bytes 
do  tipo
.BR long ,
escrito na ordem de bytes ''padrão'' (o byte de mais alta ordem do valor é
escrito primeiro.
Este valores são,
na ordem:
.TP
.I tzh_ttisgmtcnt
O número do indicador UTC/local armazenado no arquivo.
.TP
.I tzh_ttisstdcnt
O número do indicador padrão/pareee armazenado no arquivo
.TP
.I tzh_leapcnt
O número do salto de segundos para qual dado é armazenado no arquivo.
.TP
.I tzh_timecnt
O número de "transition times" para qual dado é armazenado
no arquivo.
.TP
.I tzh_typecnt
O número de "local time types" para qual dado é armazenado
no arquivo (não pode ser zero).
.TP
.I tzh_charcnt
O número de caracteres da "time zone abbreviation strings"
armazenado no arquivo.
.PP
O cabeçalho citado acima é seguido por
.I tzh_timecnt
valores de quatro-bytes do tipo
.BR long ,
ordenados em ordem ascendente.
Estes valores são escritos na ordem ''padrão''.
Cada um é usado como um tempo de transição (como devolvido por
.IR time (2))
na regra para computar o tempo local alterada.
Depois chega
.I tzh_timecnt
valor de um byte do tipo
.BR "unsigned char" ;
cada um conta qual dos diferentes tipos de ''local time'' descritos
no arquivo associado com o tempo de translação como indexado.
Aqueles valores servem com indice dentro de um matriz de estrutura
.I ttinfo
que mostra-se próxima no arquivo;
estas estruturas são definidas com segue:
.in +.5i
.sp
.nf
.ta .5i +\w'unsigned int\0\0'u
struct ttinfo {
	long	tt_gmtoff;
	int	tt_isdst;
	unsigned int	tt_abbrind;
};
.in -.5i
.fi
.sp
Cada estrutura é escrita com um valor de 4 bytes oara
.I tt_gmtoff
do tipo
.BR long ,
na ordem padrão de bytes, seguida por um valor de um byte para
.I tt_isdst
e um valor de um byte para
.IR tt_abbrind .
Em cada estrutura,
.I tt_gmtoff
fornece o número de segundo para ser adicionado ao UTC,
.I tt_isdst
conta se
.I tm_isdst
deverá se selecionado por
.I localtime (3)
e
.I tt_abbrind
tem função de um indexador dentro da matriz de abreviação de caracteres defusos horários
que seguem a(s) estrutura(s)
.I ttinfo
no arquivo.
.PP
Então ali está o par
.I tzh_leapcnt
de valores de quatro bytes, escritos na ordem padrão de byes;
o primeiro valor de cada para fornece o tempo
(como retornado por
.IR time(2))
no qual ocorre um salto de segundo;
o número de segundo fornecido
.I total
de saltos de segundo aplicados depois do tempo dado.
O par de valores são ordenados e ordem ascendente por time.
.PP
Então ali estão
.I tzh_ttisstdcnt
indicadore padrão/parede, cada um arqmazenado com um valor de um byte;
eles contam o tempo de transição associado com o tipo de tempo local
sendo especificado com um tempo local padrão ou tempo do relógio de parede,
e são usado quando um arquivo de fuso horário é usado para tratamento de
variáveis de ambiente no estilo POSIX de fuso horários.
.PP
Finalmente ali estão
.I tzh_ttisgmtcnt
indicadores UTC/local, cada um armazenado como um valor de um byte;
eles contam o tempo de transição associado com o tipo de tempo local
sendo especificado como UTC ou tempo local,
e são usado quando um arquivo de fuso horário é usado para tratamento de
variáveis de ambiente no estilo POSIX de fuso horários.
.PP
.I Localtime
usar o primeiro tempo padrão
.I ttinfo
estrutura no arquivo
(ou simplesmente a primeira
.I ttinfo
estrutura na ausência de m estrutura padrão de tempo)
se
.I tzh_timecnt
é zero ou se o arguentp de tempo é menor que o primeiro caractere de transição de tempo
gravado no arquivo.
.SH "VEJA TAMBÉM"
newctime(3)
.\" @(#)tzfile.5	7.11
.\" Este arquivo é de domínio público, assim esclarescer como 
.\" 1996-06-05 por Arthur David Olson (arthur_david_olson@nih.gov).
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndré L. Fassone Canova <lonelywolf@blv.com.br> (tradução)\fR
\&\fR\&\f(CWCarlos Augusto Horylka <horylka@conectiva.com.br> (revisão)\fR