Provided by: manpages-es_1.55-10_all 
NOMBRE
tzset, tzname, timezone, daylight - inicializa la información de conversión horaria
SINOPSIS
#include <time.h>
void tzset (void);
extern char *tzname[2];
extern long timezone;
extern int daylight;
DESCRIPCIÓN
La función tzset() inicializa la variable tzname a partir de la variable de entorno TZ.
Esta función es invocada automáticamente por otras funciones conversoras de tiempo que
dependen de la zona horaria. En un entorno de tipo SysV se establecerá también 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 energético, distinto de cero si hay algún período
durante el que se apliquen horarios de ahorro energético).
Si la variable TZ no está presente en el entorno, la variable tzname se inicializa con la
mejor aproximación 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 más abajo).
(También es frecuente que el fichero /etc/localtime usado aquí, sea un enlace simbólico al
fichero correcto en el directorio de huso horario del sistema.)
Si la variable TZ está 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 energético en la zona horaria local:
nzh desfase
La cadena nzh especifica el nombre de la zona horaria y debe componerse de tres o más
caracteres alfabéticos. La cadena desfase sigue inmediatamente después de nzh y especifica
el tiempo a añadir a la hora local para obtener el Tiempo Coordinado Universal (UTC). El
valor de desfase es positivo si la hora local está al oeste del meridiano de Greenwich y
negativo si está 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 energético:
nzh desfase hae [desfase],inicio[/hora],fin[/hora]
No hay espacios en la especificación. El nzh y el desfase iniciales especifican la zona
horaria estándar tal como se describe arriba. Las cadenas hae y desfase especifican el
nombre y desfase para el correspondiente horario de ahorro energético de la zona. Si se
omite el desfase, se asume el valor de una hora por delante de la hora estándar.
El campo inicio especifica cuándo entra en vigor el horario de ahorro energético y el
campo fin cuándo se vuelve al horario estándar. Estos campos pueden tener los siguientes
formatos:
Jn Especifica el día juliano, siendo n entre 1 y 365. El 29 de febrero nunca se
cuenta, ni siquiera en los años bisiestos.
n Especifica el día juliano, siendo n entre 1 y 365. El 29 de febrero se cuenta en
los años bisiestos.
Mm.s.d Especifica el día 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 día d y la semana 5 es la
última en el que ocurre el día d. El día 0 es un domingo.
Los campos hora especifican cuándo (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 información de la zona horaria debe leerse de un
fichero:
:[fichero]
Si se omite la especificación de fichero, la información 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 información de la
zona horaria. Si fichero no comienza con `/', la especificación de fichero es relativa al
directorio de huso horario del sistema.
FICHEROS
El directorio de huso horario del sistema utilizado depende de la versión de (g)libc.
Libc4 y libc5 usan /usr/lib/zoneinfo y, desde libc-5.4.6, /usr/share/zoneinfo. Glibc2
usará la variable de entorno TZDIR cuando ésta exista. Su valor por defecto depende de
cómo 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 simbólico 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 energético
en el momento. Suele dar el número de algún algoritmo (vea la variable tz_dsttime en
gettimeofday(2)). Ha estado obsoleta muchos años pero es requerida por SUSv2.
BSD4.3 tenía una rutina char *timezone(zone,dst) que devolvía 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 estándar y, en caso contrario, la versión de tiempo de ahorro
energético.
VÉASE TAMBIÉN
date(1), gettimeofday(2), time(2), ctime(3), getenv(3), tzfile(5)
13 noviembre 2001 TZSET(3)