| tzset.3 (116021) | tzset.3 (131504) |
|---|---|
| 1.\" Copyright (c) 1989, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" Arthur Olson. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 19 unchanged lines hidden (view full) --- 28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" @(#)tzset.3 8.2 (Berkeley) 11/17/93 | 1.\" Copyright (c) 1989, 1991, 1993 2.\" The Regents of the University of California. All rights reserved. 3.\" 4.\" This code is derived from software contributed to Berkeley by 5.\" Arthur Olson. 6.\" 7.\" Redistribution and use in source and binary forms, with or without 8.\" modification, are permitted provided that the following conditions --- 19 unchanged lines hidden (view full) --- 28.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 29.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 30.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 31.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.\" @(#)tzset.3 8.2 (Berkeley) 11/17/93 |
| 36.\" $FreeBSD: head/lib/libc/gen/tzset.3 116021 2003-06-08 10:01:52Z charnier $ | 36.\" $FreeBSD: head/lib/libc/gen/tzset.3 131504 2004-07-02 23:52:20Z ru $ |
| 37.\" 38.Dd November 17, 1993 39.Dt TZSET 3 40.Os 41.Sh NAME 42.Nm tzset , 43.Nm tzsetwall 44.Nd initialize time conversion information --- 81 unchanged lines hidden (view full) --- 126.Pp 127Where: 128.Bl -tag -width std_and_dst -offset indent 129.It Em std No and Em dst 130Three or more bytes that are the designation for the standard 131.Pq Em std 132or summer 133.Pq Em dst | 37.\" 38.Dd November 17, 1993 39.Dt TZSET 3 40.Os 41.Sh NAME 42.Nm tzset , 43.Nm tzsetwall 44.Nd initialize time conversion information --- 81 unchanged lines hidden (view full) --- 126.Pp 127Where: 128.Bl -tag -width std_and_dst -offset indent 129.It Em std No and Em dst 130Three or more bytes that are the designation for the standard 131.Pq Em std 132or summer 133.Pq Em dst |
| 134time zone. Only | 134time zone. 135Only |
| 135.Em std 136is required; if 137.Em dst 138is missing, then summer time does not apply in this locale. | 136.Em std 137is required; if 138.Em dst 139is missing, then summer time does not apply in this locale. |
| 139Upper and lowercase letters are explicitly allowed. Any characters | 140Upper and lowercase letters are explicitly allowed. 141Any characters |
| 140except a leading colon 141.Pq Ql \&: , 142digits, comma 143.Pq Ql \&, , 144minus 145.Pq Ql \- , 146plus 147.Pq Ql + , 148and 149.Tn ASCII 150.Dv NUL 151are allowed. 152.It Em offset 153Indicates the value one must add to the local time to arrive at | 142except a leading colon 143.Pq Ql \&: , 144digits, comma 145.Pq Ql \&, , 146minus 147.Pq Ql \- , 148plus 149.Pq Ql + , 150and 151.Tn ASCII 152.Dv NUL 153are allowed. 154.It Em offset 155Indicates the value one must add to the local time to arrive at |
| 154Coordinated Universal Time. The | 156Coordinated Universal Time. 157The |
| 155.Em offset 156has the form: 157.Bd -ragged -offset indent 158.Sm off 159.Em hh Bo 160.Em : mm 161.Bq Em : ss 162.Bc 163.Sm on 164.Ed 165.Pp 166The minutes 167.Pq Em mm 168and seconds 169.Pq Em ss | 158.Em offset 159has the form: 160.Bd -ragged -offset indent 161.Sm off 162.Em hh Bo 163.Em : mm 164.Bq Em : ss 165.Bc 166.Sm on 167.Ed 168.Pp 169The minutes 170.Pq Em mm 171and seconds 172.Pq Em ss |
| 170are optional. The hour | 173are optional. 174The hour |
| 171.Pq Em hh | 175.Pq Em hh |
| 172is required and may be a single digit. The | 176is required and may be a single digit. 177The |
| 173.Em offset 174following 175.Em std | 178.Em offset 179following 180.Em std |
| 176is required. If no | 181is required. 182If no |
| 177.Em offset 178follows 179.Em dst , | 183.Em offset 184follows 185.Em dst , |
| 180summer time is assumed to be one hour ahead of standard time. One or | 186summer time is assumed to be one hour ahead of standard time. 187One or |
| 181more digits may be used; the value is always interpreted as a decimal | 188more digits may be used; the value is always interpreted as a decimal |
| 182number. The hour must be between zero and 24, and the minutes (and 183seconds) \(em if present \(em between zero and 59. If preceded by a | 189number. 190The hour must be between zero and 24, and the minutes (and 191seconds) \(em if present \(em between zero and 59. 192If preceded by a |
| 184.Pq Ql \- 185the time zone shall be east of the Prime Meridian; otherwise it shall be 186west (which may be indicated by an optional preceding 187.Pq Ql + ) . 188.It Em rule | 193.Pq Ql \- 194the time zone shall be east of the Prime Meridian; otherwise it shall be 195west (which may be indicated by an optional preceding 196.Pq Ql + ) . 197.It Em rule |
| 189Indicates when to change to and back from summer time. The | 198Indicates when to change to and back from summer time. 199The |
| 190.Em rule 191has the form: 192.Bd -ragged -offset indent 193.Em date/time,date/time 194.Ed 195.Pp 196where the first 197.Em date 198describes when the change from standard to summer time occurs and the 199second 200.Em date | 200.Em rule 201has the form: 202.Bd -ragged -offset indent 203.Em date/time,date/time 204.Ed 205.Pp 206where the first 207.Em date 208describes when the change from standard to summer time occurs and the 209second 210.Em date |
| 201describes when the change back happens. Each | 211describes when the change back happens. 212Each |
| 202.Em time 203field describes when, in current local time, the change to the other 204time is made. 205.Pp 206The format of 207.Em date 208is one of the following: 209.Bl -tag -width "M.m.n.d" 210.It Sy J Em n 211The Julian day 212.Em n 213(1 \*(Le 214.Em n 215\*(Le 365). 216Leap days are not counted; that is, in all years \(em including leap | 213.Em time 214field describes when, in current local time, the change to the other 215time is made. 216.Pp 217The format of 218.Em date 219is one of the following: 220.Bl -tag -width "M.m.n.d" 221.It Sy J Em n 222The Julian day 223.Em n 224(1 \*(Le 225.Em n 226\*(Le 365). 227Leap days are not counted; that is, in all years \(em including leap |
| 217years \(em February 28 is day 59 and March 1 is day 60. It is | 228years \(em February 28 is day 59 and March 1 is day 60. 229It is |
| 218impossible to explicitly refer to the occasional February 29. 219.It Em n 220The zero-based Julian day 221(0 \*(Le 222.Em n 223\*(Le 365 ) . 224Leap days are counted, and it is possible to refer to February 29. 225.It Sy M Em m.n.d --- 15 unchanged lines hidden (view full) --- 241\*(Le 12), 242where week 5 means 243.Do 244the last 245.Em d 246day in month 247.Em m 248.Dc | 230impossible to explicitly refer to the occasional February 29. 231.It Em n 232The zero-based Julian day 233(0 \*(Le 234.Em n 235\*(Le 365 ) . 236Leap days are counted, and it is possible to refer to February 29. 237.It Sy M Em m.n.d --- 15 unchanged lines hidden (view full) --- 253\*(Le 12), 254where week 5 means 255.Do 256the last 257.Em d 258day in month 259.Em m 260.Dc |
| 249which may occur in either the fourth or the fifth week). Week 1 is the | 261which may occur in either the fourth or the fifth week). 262Week 1 is the |
| 250first week in which the 251.Em d Ns 'th | 263first week in which the 264.Em d Ns 'th |
| 252day occurs. Day zero is Sunday. | 265day occurs. 266Day zero is Sunday. |
| 253.Pp 254The 255.Em time 256has the same format as 257.Em offset 258except that no leading sign 259.Pq Ql \- 260or 261.Pq Ql + | 267.Pp 268The 269.Em time 270has the same format as 271.Em offset 272except that no leading sign 273.Pq Ql \- 274or 275.Pq Ql + |
| 262is allowed. The default, if | 276is allowed. 277The default, if |
| 263.Em time 264is not given, is 265.Sy 02:00:00 . 266.El 267.Pp 268If no 269.Em rule 270is present in the --- 57 unchanged lines hidden --- | 278.Em time 279is not given, is 280.Sy 02:00:00 . 281.El 282.Pp 283If no 284.Em rule 285is present in the --- 57 unchanged lines hidden --- |