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
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
.\" 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 Sat Jul 24 19:49:27 1993 by Rik Faith (faith@cs.unc.edu)
.\"
.\" Traducido al castellano (con permiso) por:
.\" Sebastian Desimone (chipy@argenet.com.ar) (desimone@fasta.edu.ar)
.\" Translation fixed on Thu Apr 23 16:27:38 CEST 1998 by
.\" Gerardo Aburruzaga Garca <gerardo.aburruzaga@uca.es>
.\" Translation revised on Sun Apr 4 1999 by Juan Piernas <piernas@ditec.um.es>
.\"
.TH CTIME 3 "9 Enero 1995" "BSD" "Manual del Programador de Linux"
.SH NOMBRE
asctime, ctime, gmtime, localtime, mktime \- transforman fechas y horas
binarias a ASCII
.SH SINOPSIS
.nf
.B #include <time.h>
.sp
.BI "char *asctime(const struct tm *" timeptr );
.sp
.BI "char *ctime(const time_t *" timep );
.sp
.BI "struct tm *gmtime(const time_t *" timep );
.sp
.BI "struct tm *localtime(const time_t *" timep );
.sp
.BI "time_t mktime(struct tm *" timeptr );
.sp
.BI "extern char *" tzname [2];
.BI "long int " timezone ;
.BI "extern int " daylight ;
.fi
.SH DESCRIPCIN
La funciones \fBctime()\fP, \fBgmtime()\fP y \fBlocaltime()\fP toman
todas un argumento de tipo \fItime_t\fP que representa el tiempo de calendario.
Al ser interpretado como un valor de tiempo absoluto, representa el
nmero de segundos transcurridos desde las 00:00:00 del 1 de Enero de 1970,
en Tiempo Universal Coordinado, Coordinated Universal Time (UTC).
.PP
Las funciones \fBasctime()\fP y \fBmktime()\fP toman un argumento
que representa el tiempo descompuesto, que es una representacin binaria
separada en ao, mes, da, etc. El tiempo descompuesto se guarda en
una estructura \fItm\fP, que se define en \fI<time.h>\fP como sigue:
.sp
.RS
.nf
.ne 12
.ta 8n 16n 32n
struct tm
{
int tm_sec; /* segundos */
int tm_min; /* minutos */
int tm_hour; /* horas */
int tm_mday; /* da del mes */
int tm_mon; /* mes */
int tm_year; /* ao */
int tm_wday; /* da de la semana */
int tm_yday; /* da del ao */
int tm_isdst; /* cambio horario verano/invierno */
};
.ta
.fi
.RE
.PP
Los miembros de la estructura \fItm\fP son:
.TP
.I tm_sec
El nmero de segundos, normalmente en el rango de 0 a 59, pero puede llegar
a 61 para permitir segundos bisiestos.
.TP
.I tm_min
El nmero de minutos, en el rango de 0 a 59.
.TP
.I tm_hour
El nmero de horas pasada la medianoche, en el rango de 0 a 23.
.TP
.I tm_mday
El da del mes, en el rango de 1 a 31.
.TP
.I tm_mon
El nmero de meses desde Enero, en el rango de 0 a 11.
.TP
.I tm_year
El nmero de aos desde 1900.
.TP
.I tm_wday
El nmero de dias desde el Domingo, en el rango de 0 a 6.
.TP
.I tm_yday
El nmero de dias desde el 1 de Enero en el rango de 0 a 365.
.TP
.I tm_isdst
Un indicador que dice si existe cambio horario entre verano e invierno
para el tiempo descrito. El valor es positivo si existe este cambio,
cero si no lo hay, y negativo si la informacin no est
disponible.
.PP
La funcin \fBctime()\fP convierte el tiempo de calendario \fItimep\fP a una
cadena de la forma
.sp
.RS
"Wed Jun 30 21:49:08 1993\\n"
.RE
.sp
Las abreviaturas para los dias de la semana son `Sun', `Mon', `Tue', `Wed',
`Thu', `Fri', y `Sat'. Las abreviaturas para los meses son `Jan',
`Feb', `Mar', `Apr', `May', `Jun', `Jul', `Aug', `Sep', `Oct', `Nov', y
`Dec'. El valor devuelto apunta a una cadena reservada estticamente que
puede ser sobreescrita por posteriores llamadas a cualquiera de las
funciones de fecha u hora. La funcin tambin pone en la variable externa
\fItzname\fP informacin acerca del huso horario.
.PP
La funcin \fBgmtime()\fP convierte el tiempo de calendario \fItimep\fP a una
representacin descompuesta del tiempo, expresado en Tiempo Universal
Coordinado (UTC).
.PP
La funcin \fBlocaltime()\fP convierte el tiempo de calendario \fItimep\fP a
una representacin descompuesta, expresada relativa a la zona horaria
especificada por el usuario. La funcin pone en la variable externa \fItzname\fP
informacin acerca de la zona horaria en curso, en \fItimezone\fP la
diferencia entre el Tiempo Universal Coordinado (UTC) y la hora local normal
en segundos, y en \fIdaylight\fP un valor distinto de cero si las reglas del
estndar US de cambio horario de verano/invierno se aplican.
.PP
La funcin \fBasctime()\fP convierte el tiempo descompuesto
\fItimeptr\fP a una cadena con el mismo formato que \fBctime()\fP.
El valor devuelto apunta a una cadena reservada estticamente que
puede ser sobreescrita por posteriores llamadas a cualquiera de las
funciones de fecha u hora.
.PP
La funcin \fBmktime()\fP convierte un tiempo descompuesto a
una representacin tiempo de calendario. La funcin hace caso omiso de los
contenidos especfcos en los miembros de la estructura \fItm_wday\fP y
\fItm_yday\fP y los recalcula a partir de otra informacin existente
en la estructura del tiempo descompuesto.
Si los miembros de la estructura estn fuera de sus intervalos permitidos,
sern normalizados (del tal manera que, por ejemplo, el 40 de octubre se
cambiar al 9 de noviembre).
Al llamar a \fBmktime()\fP tambin se pone un valor en la variable externa
\fItzname\fP con informacin acerca de la zona horaria. Si el tiempo
descompuesto especificado no puede representarse como tiempo de calendario
(segundos desde la `poca'), \fBmktime()\fP devuelve el valor (time_t)(\-1)
y no altera los miembros \fItm_wday\fP ni \fItm_yday\fP de la estructura del
tiempo descompuesto.
.SH "CONFORME A"
SVID 3, POSIX, BSD 4.3, ISO 9899
.SH "VASE TAMBIN"
.BR date "(1), " gettimeofday "(2), " time "(2), " tzset (3),
.BR difftime "(3), " strftime (3)
|
