1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of this
.\" manual under the conditions for verbatim copying, provided that the
.\" entire resulting derived work is distributed under the terms of a
.\" permission notice identical to this one
.\"
.\" Since the Linux kernel and libraries are constantly changing, this
.\" manual page may be incorrect or out-of-date. The author(s) assume no
.\" responsibility for errors or omissions, or for damages resulting from
.\" the use of the information contained herein. The author(s) may not
.\" have taken the same level of care in the production of this manual,
.\" which is licensed free of charge, as they might when working
.\" professionally.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
.\"
.\" References consulted:
.\" Linux libc source code
.\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
.\" 386BSD man pages
.\" Modified Sun Jul 25 11:01:58 1993 by Rik Faith (faith@cs.unc.edu)
.\" Traduccin por Urko Lusa <ulusa@lacueva.ddns.org> 19980323
.TH TZSET 3 "2 de julio de 1993" "BSD" "Manual del programador de Linux"
.SH NOMBRE
tzset \- inicializa la informacin de conversin horaria
.SH SINOPSIS
.nf
.B #include <time.h>
.sp
.B void tzset (void);
.sp
.BI "extern char *" tzname [2]
.fi
.SH DESCRIPCIN
La funcin \fBtzset()\fP inicializa la variable \fItzname\fP a partir de la
variable de entorno TZ. Esta funcin es invocada automticamente por otras
funciones conversoras de tiempo que dependen de la zona horaria.
.PP
Si la variable TZ no est presente en el entorno, la variable \fItzname\fP
se inicializa con la mejor aproximacin de la hora local, tal como se
especifica en el fichero \fI/usr/lib/zoneinfo/localtime\fP, cuyo formato se
detalla en
.BR tzfile (5).
.PP
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).
.PP
La variable TZ puede tener tres formatos. El primero se usa cuando no
hay horario de ahorro energtico en la zona horaria local:
.sp
.RS
.I nzh desfase
.RE
.sp
La cadena \fInzh\fP especifica el nombre de la zona horaria, y debe
componerse de tres o ms caracteres alfabticos. La cadena \fIdesfase\fP
sigue inmediatamente despus de \fInzh\fP y especifica el tiempo a aadir a
la hora local para obtener el Tiempo Coordinado Universal (UTC). El valor de
\fIdesfase\fP 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.
.PP
El segundo formato se usa cuando hay horario de ahorro energtico:
.sp
.RS
.I nzh desfase hae [desfase],inicio[/hora],fin[/hora]
.RE
.sp
No hay espacios en la especificacin. El \fInzh\fP y el \fIdesfase\fP
iniciales especifican la zona horaria estndar tal como se describe arriba.
Las cadenas \fIhae\fP y \fIdesfase\fP especifican el nombre y desfase para
el correspondiente horario de ahorro energtico de la zona. Si se omite el
desfase, se asume el valor de una hora por delante de la hora estndar.
.PP
El campo \fIinicio\fP especifica cundo entra en vigor el horario de ahorro
energtico, y el campo \fIfin\fP cundo se vuelve al horario estndar. Estos
campos pueden tener los siguientes formatos:
.TP
J\fIn\fP
Especifica el da juliano, siendo \fIn\fP entre 1 y 365. El 29 de febrero
nunca se cuenta, ni siquiera en los aos bisiestos.
.TP
.I n
Especifica el da juliano, siendo \fIn\fP entre 1 y 365. El 29 de febrero se
cuenta en los aos bisiestos.
.TP
M\fIm\fP.\fIs\fP.\fId\fP
Especifica el da \fId\fP (0 <= \fId\fP <= 6) de la semana \fIs\fP (1 <=
\fIs\fP <= 5) del mes \fIm\fP (1 <= \fIm\fP <= 12). La semana 1 es la
primera semana en la que ocurre el da \fId\fP, y la semana 5 es la ltima
en el que ocurre el da \fId\fP. El da 0 es un domingo.
.PP
Los campos \fIhora\fP especifican cundo (en el horario local actualmente en
vigor) ocurre el cambio al otro horario. Si se omite, el valor por defecto
es 02:00:00.
.PP
El tercer formato especifica que la informacin de la zona horaria debe
leerse de un fichero:
.sp
.RS
:[fichero]
.RE
.sp
Si se omite la especificacin de fichero \fIfichero\fP, la informacin de la
zona horaria se lee de \fI/usr/lib/zoneinfo/localtime\fP, que est en
formato
.BR tzfile (5).
Si se proporciona \fIfichero\fP, especifica otro fichero de formato
.BR tzfile (5)
del que leer la informacin de la zona horaria. Si \fIfichero\fP no comienza
con `/', la especificacin de fichero es relativa al directorio de
conversin horaria del sistema \fI/usr/lib/zoneinfo\fP.
.SH FICHEROS
.nf
/usr/lib/zoneinfo directorio de zonas horarias
/usr/lib/zoneinfo/localtime fichero de horario local
/usr/lib/zoneinfo/posixrules reglas para TZ estilo POSIX
.fi
.SH "CONFORME A"
SVID 3, POSIX, BSD 4.3
.SH "VASE TAMBIN"
.BR date "(1), " gettimeofday "(2), " time "(2), " ctime (3),
.BR getenv "(3), " tzfile (5)
|
