TZSET(3)

NOME
tzset - inicializa informação para conversão do horário

SINÓPSE
#include <time.h>

void tzset (void);

extern char *tzname[2]

DESCRIÇÃO
A função tzset() inicializa a variável tzname da variável de ambiente TZ. Esta função é automáticamente chamada por outras funções de conversão de horário que dependem do fuso horário.

Se a variável TZ não aparece no ambiente, a variável tzname é inicializada com a melhor aproximação ao horário do relógio de parede, como especificado pelo tzfile(5)-formato de arquivo localtime encontrado no sistema no diretório de fuso horário (veja abaixo). (Pode-se também ver /etc/localtime utilizado aqui, uma ligação simbólica para o arquivo correto no diretório de fuso horário do sistema.)

Se a variável TZ não aparece no ambiente mas seu valor é NULO ou seu valor pode ser interpretado utilizando qualquer dos formatos especificados abaixo, UCT (Tempo Coordenado Universal) é utilizado.

O valor de TZ pode ser um dos seguintes três formatos. O primeiro formato é utilizado quando não há horário de verão no fuso horário local:

    std offset

A seqüencia std especifica o nome de uma região de fuso horário e tem que ter três ou mais caracteres alfabéticos. A seqüencia offset segue imediatamente std e especifica o valor do tempo à ser adicionado ao horário local para obter o Tempo Universal Coordenado (UTC). O offset é positivo se a região de fuso for a oeste do Meridiano Principal e negativo se ela for à leste. A hora deve estar entre 0 e 24, e minutos e segundos de 0 e 59.

O segundo formato é usado quando há horário de verão:

    std offset dst [offset],start[/time],end[/time]

Não há espaços na especificação. O std inicial e offset especifica o horário padrão, como descrito acima. A 'string' dst e offset especificam o nome e desvio para a correspondente zona de horário de verão. Se o desvio for omitido, o padrão é definido em uma hora além do horário padrão.

O campo start especifica quando o horário de verão entra em função e o campo end especifica quando o mudança é retornada ao horário padrão. Este campos podem ter os seguintes formatos:

Jn  Este especifica o dia Juliano com n entre 1 e 365. Fevereiro 29 nunca é contado, mesmo em ano bisexto.

n   Este especifica o dia Juliano com n entre 1 e 365. Fevereiro 29 é contado em anos bisextos.

Mm.w.d
    Este especifica dia d (0 <= d <= 6) da semana w (1 <= w <= 5) do mês m (1 <= m <= 12). Semana 1 é a primeira semana no qual o dia d ocorre e semana 5 é a última semana na qual o dia d ocorre. Dia 0 é um Domingo.

O campo time especifica quando, no horário local atualmente em função, a mudança para o outro horário ocorre. Se omitido, o padrão é 02:00:00.

O terceiro formato especifica que a informação do fuso horário deveria ser lida de um arquivo:

    :[filespec]

Se a especificação de arquivo filespec for omitida, a informação do fuso horário é lida do arquivo localtime no diretório de sitema de fuso horário, o qual é atualmente /usr/share/zoneinfo. O arquivo está no formato tzfile(5). Se filespec for dado, ele especifica um outro tzfile(5)-formatodearquivo para ler a informação de fuso horários. Se filespec não começa com um `/', o arquivo de especificação é relativo ao diretório do sistema de fuso horário.

ARQUIVOS
O diretório de fuso horário utilizado depende da versão (g)libc. Libc4 e libc5 usam /usr/lib/zoneinfo, e desde libc-5.4.6, quando isto não funciona tentará /usr/share/zoneinfo. Glibc2 não utiliza a variável de ambiente TZDIR, quando ela existe. Seu padrão depende de como ela foi instalada, mas normalmente é /usr/share/zoneinfo.

Este diretório de fuso horário contém os arquivos
localtime      local time zone file
posixrules     rules for POSIX-style TZ's

Frequentemente /etc/localtime é uma ligação simbólico para o arquivo localtime ou para o arquivo de fuso horário correto no diretório de sistema de fuso horário.

DE ACORDO COM
SVID 3, POSIX, BSD 4.3.

VEJA TAMBÉM
date(1), gettimeofday(2), time(2), ctime(3), getenv(3), tzfile(5).

TRADUZIDO POR LPD-BR em 08/06/2001.

  Tradução:
Ricardo C.O.Freitas <english.quest@best-service.com>

  Revisão.:
André Luiz Fassone <lonely_wolf@ig.com.br>