[BACK]Return to tzset.3 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libc / time

Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files.

Diff for /src/lib/libc/time/tzset.3 between version 1.37 and 1.37.2.2

version 1.37, 2018/01/25 22:48:42 version 1.37.2.2, 2018/10/20 06:58:22
Line 1 
Line 1 
 .\"     $NetBSD$  .\"     $NetBSD$
 .Dd January 25, 2018  .Dd October 19, 2018
 .Dt TZSET 3  .Dt TZSET 3
 .Os  .Os
 .Sh NAME  .Sh NAME
Line 37  functions.
Line 37  functions.
 .Pp  .Pp
 If  If
 .Ar tz  .Ar tz
 is not a valid time zone description, or if the object cannot be allocated,  is not a valid timezone description, or if the object cannot be allocated,
 .Fn tzalloc  .Fn tzalloc
 returns a  returns a
 .Dv NULL  .Dv NULL
Line 104  The
Line 104  The
 .Fn tzset  .Fn tzset
 function acts like  function acts like
 .Dv tzalloc(getenv("TZ")) ,  .Dv tzalloc(getenv("TZ")) ,
 except it saves any resulting time zone object into internal  except it saves any resulting timezone object into internal
 storage that is accessed by  storage that is accessed by
 .Fn localtime ,  .Fn localtime ,
 .Fn localtime_r ,  .Fn localtime_r ,
 and  and
 .Fn mktime .  .Fn mktime .
 The anonymous shared time zone object is freed by the next call to  The anonymous shared timezone object is freed by the next call to
 .Fn tzset .  .Fn tzset .
 If the implied call to  If the implied call to
 .Fn tzalloc  .Fn tzalloc
Line 175  where:
Line 175  where:
 .It Cm std No and Cm dst  .It Cm std No and Cm dst
 Three or more bytes that are the designation for the standard  Three or more bytes that are the designation for the standard
 .Cm ( std )  .Cm ( std )
 or summer  or the alternative
 .Cm ( dst )  .Cm ( dst
 time zone.  such as daylight saving time)
   timezone.
 Only  Only
 .Cm std  .Cm std
 is required; if  is required; if
 .Cm dst  .Cm dst
 is missing, then summer time does not apply in this locale.  is missing, then daylight saving time does not apply in this locale.
 Upper- and lowercase letters are explicitly allowed.  Upper- and lowercase letters are explicitly allowed.
 Any characters except a leading colon (:), digits, comma (,), minus (-),  Any characters except a leading colon (:), digits, comma (,), minus (-),
 plus (+), and NUL bytes are allowed.  plus (+), and NUL bytes are allowed.
Line 225  If no
Line 226  If no
 .Cm offset  .Cm offset
 follows  follows
 .Cm dst ,  .Cm dst ,
 summer time is assumed to be one hour ahead of standard time.  daylight saving time is assumed to be one hour ahead of standard time.
 One or more digits may be used; the value is always interpreted as a  One or more digits may be used; the value is always interpreted as a
 decimal number.  decimal number.
 The hour must be between zero and 24, and the minutes (and  The hour must be between zero and 24, and the minutes (and
 seconds) \*(en if present \*(en between zero and 59.  seconds) \*(en if present \*(en between zero and 59.
 If preceded by a  If preceded by a
 .Dq -  .Dq -
 the time zone shall be east of the Prime Meridian; otherwise it shall be  the timezone shall be east of the Prime Meridian; otherwise it shall be
 west (which may be indicated by an optional preceding  west (which may be indicated by an optional preceding
 .Dq + ) .  .Dq + ) .
 .It Cm rule  .It Cm rule
 Indicates when to change to and back from summer time.  Indicates when to change to and back from daylight saving time.
 The  The
 .Cm rule  .Cm rule
 has the form:  has the form:
Line 253  has the form:
Line 254  has the form:
 .Pp  .Pp
 where the first  where the first
 .Cm date  .Cm date
 describes when the change from standard to summer time occurs and the  describes when the change from standard to daylight saving time occurs and the
 second  second
 .Cm date  .Cm date
 describes when the change back happens.  describes when the change back happens.
Line 330  is not given, is
Line 331  is not given, is
 .Pp  .Pp
 Here are some examples of  Here are some examples of
 .Va TZ  .Va TZ
 values that directly specify the time zone rules; they use some of the  values that directly specify the timezone rules; they use some of the
 extensions to POSIX.  extensions to POSIX.
 .Bl -tag  .Bl -tag
 .It EST5  .It EST5
 stands for US Eastern Standard  stands for US Eastern Standard
 Time (EST), 5 hours behind UT, without daylight saving.  Time (EST), 5 hours behind UT, without daylight saving.
 .It FJT\-12FJST,M11.1.0,M1.3.4/75  .It FJT\-12FJST,M11.1.0,M1.3.4/75
 stands for Fiji Time (FJT) and Fiji Summer Time (FJST), 12 hours ahead  .It <+12>\-12<+13>,M11.1.0,M1.2.1/147
   stands for Fiji time, 12 hours ahead
 of UT, springing forward on November's first Sunday at 02:00, and  of UT, springing forward on November's first Sunday at 02:00, and
 falling back on January's third Thursday at 75:00 (i.e., 03:00 on the  falling back on January's second Monday at 147:00 (i.e., 03:00 on the
 first Sunday on or after January 18).  first Sunday on or after January 14).
   The abbreviations for standard and daylight saving time are
   .Qq +12
   and
   .Qq +13 .
 .It IST\-2IDT,M3.4.4/26,M10.5.0  .It IST\-2IDT,M3.4.4/26,M10.5.0
 stands for Israel Standard Time (IST) and Israel Daylight Time (IDT),  stands for Israel Standard Time (IST) and Israel Daylight Time (IDT),
 2 hours ahead of UT, springing forward on March's fourth  2 hours ahead of UT, springing forward on March's fourth
 Thursday at 26:00 (i.e., 02:00 on the first Friday on or after March  Thursday at 26:00 (i.e., 02:00 on the first Friday on or after March
 23), and falling back on October's last Sunday at 02:00.  23), and falling back on October's last Sunday at 02:00.
 .It WART4WARST,J1/0,J365/25  .It <\-04>4<\-03>,J1/0,J365/25
 stands for Western Argentina Summer Time (WARST), 3 hours behind UT.  stands for permanent daylight saving time, 3 hours behind UT with
   abbreviation
   .Qq \-03 .
 There is a dummy fall-back transition on December 31 at 25:00 daylight  There is a dummy fall-back transition on December 31 at 25:00 daylight
 saving time (i.e., 24:00 standard time, equivalent to January 1 at  saving time (i.e., 24:00 standard time, equivalent to January 1 at
 00:00 standard time), and a simultaneous spring-forward transition on  00:00 standard time), and a simultaneous spring-forward transition on
 January 1 at 00:00 standard time, so daylight saving time is in effect  January 1 at 00:00 standard time, so daylight saving time is in effect
 all year and the initial  all year and the initial
 .Em WART  .Em <\-04>
 is a placeholder.  is a placeholder.
 .It WGT3WGST,M3.5.0/\-2,M10.5.0/\-1  .It <\-03>3<\-02>,M3.5.0/\-2,M10.5.0/\-1
 stands for Western Greenland Time (WGT) and Western Greenland Summer  stands for time in western Greenland, 3 hours behind UT, where clocks
 Time (WGST), 3 hours behind UT, where clocks follow the EU rules of  follow the EU rules of
 springing forward on March's last Sunday at 01:00 UT (\-02:00 local  springing forward on March's last Sunday at 01:00 UT (\-02:00 local
 time) and falling back on October's last Sunday at 01:00 UT  time, i.e., 22:00 the previous day) and falling back on October's last
 (\-01:00 local time).  Sunday at 01:00 UT (\-01:00 local time, i.e., 23:00 the previous day).
   The abbreviations for standard and daylight saving time are
   .Qq \-03
   and
   .Qq \-02 .
 .El  .El
 .Pp  .Pp
 If no  If no
Line 373  format file
Line 385  format file
 .Pa posixrules  .Pa posixrules
 in  in
 .Pa /usr/share/zoneinfo  .Pa /usr/share/zoneinfo
 are used, with the standard and summer time offsets from UT replaced  are used, with the standard and daylight saving time offsets from UT replaced
 by those specified by the  by those specified by the
 .Cm offset  .Cm offset
 values in  values in
Line 386  from the rest of the specification.
Line 398  from the rest of the specification.
 .Sh FILES  .Sh FILES
 .Bl -tag -width /usr/share/zoneinfo/posixrules -compact  .Bl -tag -width /usr/share/zoneinfo/posixrules -compact
 .It Pa /etc/localtime  .It Pa /etc/localtime
 local time zone file  local timezone file
 .It Pa /usr/share/zoneinfo  .It Pa /usr/share/zoneinfo
 time zone information directory  local timezone information directory
 \" .It Pa /usr/share/zoneinfo/localtime  .\" .It Pa /usr/share/zoneinfo/localtime
 \" local time zone file  .\" local timezone file
 .It Pa /usr/share/zoneinfo/posixrules  .It Pa /usr/share/zoneinfo/posixrules
 used with POSIX-style TZ's  used with POSIX-style TZ's
 .It Pa /usr/share/zoneinfo/GMT  .It Pa /usr/share/zoneinfo/GMT

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.37.2.2

CVSweb <webmaster@jp.NetBSD.org>