Provided by: manpages-es_1.55-10_all bug

NOMBRE

       tzset,  tzname,  timezone,  daylight  -  inicializa  la  informacion de
       conversion horaria

SINOPSIS

       #include <time.h>

       void tzset (void);

       extern char *tzname[2];
       extern long timezone;
       extern int daylight;

DESCRIPCI'ON

       La funcion tzset()  inicializa  la  variable  tzname  a  partir  de  la
       variable  de  entorno  TZ. Esta funcion es invocada automaticamente por
       otras funciones conversoras de tiempo que dependen de la zona  horaria.
       En  un  entorno  de  tipo  SysV  se establecera tambien el valor de las
       variables timezone (segundos al Oeste de GMT) y daylight (0 si la  zona
       horaria  no tiene reglas de tiempo sobre ahorro energetico, distinto de
       cero si hay algun periodo durante el que se apliquen horarios de ahorro
       energetico).

       Si la variable TZ no esta presente en el entorno, la variable tzname se
       inicializa con la mejor aproximacion de la  hora  local,  tal  como  se
       especifica  en  el fichero /usr/lib/zoneinfo/localtime, cuyo formato se
       detalla en el fichero de formato tzfile(5) localtime localizado  en  el
       directorio  de  huso  horario del sistema (vea mas abajo).  (Tambien es
       frecuente que el fichero  /etc/localtime  usado  aqui,  sea  un  enlace
       simbolico  al  fichero  correcto  en  el directorio de huso horario del
       sistema.)

       Si la variable TZ esta presente en el entorno, pero su valor es NULL  o
       no  puede ser interpretado usando ninguno de los formatos especificados
       abajo, se usa el Tiempo Coordinado Universal (UTC).

       La variable TZ puede tener tres formatos. El primero se usa  cuando  no
       hay horario de ahorro energetico en la zona horaria local:

              nzh desfase

       La cadena nzh especifica el nombre de la zona horaria y debe componerse
       de  tres  o  mas  caracteres  alfabeticos.  La  cadena  desfase   sigue
       inmediatamente despues de nzh y especifica el tiempo a anadir a la hora
       local para obtener el Tiempo Coordinado Universal (UTC).  El  valor  de
       desfase  es  positivo  si  la hora local esta al oeste del meridiano de
       Greenwich y negativo si esta al este. La hora debe estar entre 0 y  24,
       y los minutos y segundos entre 0 y 59.

       El segundo formato se usa cuando hay horario de ahorro energetico:

              nzh desfase hae [desfase],inicio[/hora],fin[/hora]

       No  hay  espacios  en  la especificacion. El nzh y el desfase iniciales
       especifican la zona horaria estandar tal como se describe arriba.   Las
       cadenas  hae  y  desfase  especifican  el  nombre  y  desfase  para  el
       correspondiente horario de ahorro energetico de la zona. Si se omite el
       desfase, se asume el valor de una hora por delante de la hora estandar.

       El  campo  inicio especifica cuando entra en vigor el horario de ahorro
       energetico y el campo fin cuando se vuelve al horario  estandar.  Estos
       campos pueden tener los siguientes formatos:

       Jn     Especifica  el  dia  juliano,  siendo  n entre 1 y 365. El 29 de
              febrero nunca se cuenta, ni siquiera en los anos bisiestos.

       n      Especifica el dia juliano, siendo n entre 1  y  365.  El  29  de
              febrero se cuenta en los anos bisiestos.

       Mm.s.d Especifica  el  dia d (0 <= d <= 6) de la semana s (1 <= s <= 5)
              del mes m (1 <= m <= 12). La semana 1 es la primera semana en la
              que  ocurre el dia d y la semana 5 es la ultima en el que ocurre
              el dia d. El dia 0 es un domingo.

       Los campos hora especifican cuando (en el horario local actualmente  en
       vigor)  ocurre  el  cambio  al  otro horario. Si se omite, el valor por
       defecto es 02:00:00.

       El tercer formato especifica que la informacion de la zona horaria debe
       leerse de un fichero:

              :[fichero]

       Si  se  omite  la  especificacion de fichero, la informacion de la zona
       horaria se lee del fichero localtime en el directorio de  huso  horario
       del  sistema,  que  actualmente  suele  ser  /usr/share/zoneinfo.  Este
       fichero se encuentra en formato tzfile(5).  Si se proporciona  fichero,
       especifica   otro   fichero  de  formato  tzfile(5)  del  que  leer  la
       informacion de la zona horaria. Si fichero  no  comienza  con  `/',  la
       especificacion de fichero es relativa al directorio de huso horario del
       sistema.

FICHEROS

       El directorio de huso horario  del  sistema  utilizado  depende  de  la
       version  de  (g)libc.   Libc4  y  libc5 usan /usr/lib/zoneinfo y, desde
       libc-5.4.6, /usr/share/zoneinfo.  Glibc2 usara la variable  de  entorno
       TZDIR  cuando  esta  exista.   Su valor por defecto depende de como fue
       instalado, pero normalmente es /usr/share/zoneinfo.

       Este directorio de huso horario contiene los ficheros
       localtime      fichero de huso horario local
       posixrules     reglas para TZ's al estilo POSIX

       A menudo /etc/localtime es un enlace simbolico al fichero  localtime  o
       al  fichero  de  huso horario correcto en el directorio de huso horario
       del sistema.

CONFORME A

       SVID 3, POSIX, BSD 4.3

OBSERVACIONES

       Observe que la variable daylight no indica que se apliquen horarios  de
       ahorro energetico en el momento. Suele dar el numero de algun algoritmo
       (vea la variable tz_dsttime en gettimeofday(2)).   Ha  estado  obsoleta
       muchos anos pero es requerida por SUSv2.

       BSD4.3 tenia una rutina char *timezone(zone,dst) que devolvia el nombre
       de la zona horaria correspondiente a su primer  argumento  (minutos  al
       Oeste  de  GMT).  Si  el  segundo  argumento  era 0, se usaba el nombre
       estandar  y,  en  caso  contrario,  la  version  de  tiempo  de  ahorro
       energetico.

V'EASE TAMBI'EN

       date(1), gettimeofday(2), time(2), ctime(3), getenv(3), tzfile(5)

                               13 noviembre 2001                      TZSET(3)