xref: /netbsd-src/lib/libc/gen/timezone.3 (revision eb7c1594f145c931049e1fd9eb056a5987e87e59)
1*eb7c1594Sagc.\"	$NetBSD: timezone.3,v 1.12 2003/08/07 16:42:58 agc Exp $
2121197f0Schristos.\"
3121197f0Schristos.\" Copyright (c) 1991, 1993
4121197f0Schristos.\"	The Regents of the University of California.  All rights reserved.
5121197f0Schristos.\"
6121197f0Schristos.\" Redistribution and use in source and binary forms, with or without
7121197f0Schristos.\" modification, are permitted provided that the following conditions
8121197f0Schristos.\" are met:
9121197f0Schristos.\" 1. Redistributions of source code must retain the above copyright
10121197f0Schristos.\"    notice, this list of conditions and the following disclaimer.
11121197f0Schristos.\" 2. Redistributions in binary form must reproduce the above copyright
12121197f0Schristos.\"    notice, this list of conditions and the following disclaimer in the
13121197f0Schristos.\"    documentation and/or other materials provided with the distribution.
14*eb7c1594Sagc.\" 3. Neither the name of the University nor the names of its contributors
15121197f0Schristos.\"    may be used to endorse or promote products derived from this software
16121197f0Schristos.\"    without specific prior written permission.
17121197f0Schristos.\"
18121197f0Schristos.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
19121197f0Schristos.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20121197f0Schristos.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21121197f0Schristos.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
22121197f0Schristos.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23121197f0Schristos.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24121197f0Schristos.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25121197f0Schristos.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26121197f0Schristos.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27121197f0Schristos.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28121197f0Schristos.\" SUCH DAMAGE.
29121197f0Schristos.\"
30121197f0Schristos.\"	@(#)timezone.3	8.2 (Berkeley) 4/19/94
31121197f0Schristos.\"
32121197f0Schristos.Dd April 19, 1994
33121197f0Schristos.Dt TIMEZONE 3
34121197f0Schristos.Os
35121197f0Schristos.Sh NAME
36121197f0Schristos.Nm timezone
37121197f0Schristos.Nd return the timezone abbreviation
38312aca53Sperry.Sh LIBRARY
39312aca53Sperry.Lb libc
40121197f0Schristos.Sh SYNOPSIS
41121197f0Schristos.Ft char *
42121197f0Schristos.Fn timezone "int zone" "int dst"
43121197f0Schristos.Sh DESCRIPTION
44121197f0Schristos.Bf -symbolic
45121197f0Schristos.\" This interface is available from the compatibility library, libcompat;
46a495a577SkleinkThis interface is available for compatibility only and will disappear in a
47a495a577Skleinkfuture software release;
48121197f0Schristosit is impossible to reliably map timezone's arguments to a time zone
49121197f0Schristosabbreviation.
50c46ab392SfairSee
51a495a577Skleink.Xr ctime 3 ;
52a495a577Skleinksee
53a495a577Skleink.Xr tzset 3
54a495a577Skleinkfor the new definition of this interface.
55121197f0Schristos.Ef
56121197f0Schristos.Pp
57121197f0SchristosThe
58121197f0Schristos.Fn timezone
59121197f0Schristosfunction returns a pointer to a time zone abbreviation for the specified
60121197f0Schristos.Ar zone
61121197f0Schristosand
62121197f0Schristos.Ar dst
63121197f0Schristosvalues.
64121197f0Schristos.Ar Zone
65121197f0Schristosis the number of minutes west of GMT and
66121197f0Schristos.Ar dst
67121197f0Schristosis non-zero if daylight savings time is in effect.
68121197f0Schristos.Sh SEE ALSO
69a495a577Skleink.Xr ctime 3 ,
70a495a577Skleink.Xr tzset 3
71121197f0Schristos.Sh HISTORY
72121197f0SchristosA
73121197f0Schristos.Fn timezone
74121197f0Schristosfunction appeared in
75121197f0Schristos.At v7 .
76