(original) (raw)

changeset: 99763:3b7a7ea1214c branch: 3.5 parent: 99758:ded1336bff49 parent: 99762:fae779a811ec user: Senthil Kumaran senthil@uthcode.com date: Sun Jan 03 00:43:23 2016 -0800 files: Doc/library/time.rst description: merge from 3.4 Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid values and meaning. Patch contributed by Andrew Scheller. diff -r ded1336bff49 -r 3b7a7ea1214c Doc/library/time.rst --- a/Doc/library/time.rst Sat Jan 02 15:41:41 2016 -0500 +++ b/Doc/library/time.rst Sun Jan 03 00:43:23 2016 -0800 @@ -555,9 +555,11 @@ +-------+-------------------+---------------------------------+ Note that unlike the C structure, the month value is a range of [1, 12], not - [0, 11]. A ``-1`` argument as the daylight - savings flag, passed to :func:`mktime` will usually result in the correct - daylight savings state to be filled in. + [0, 11]. + + In calls to :func:`mktime`, :attr:`tm_isdst` may be set to 1 when daylight + savings time is in effect, and 0 when it is not. A value of -1 indicates that + this is not known, and will usually result in the correct state being filled in. When a tuple with an incorrect length is passed to a function expecting a :class:`struct_time`, or having elements of the wrong type, a /senthil@uthcode.com