(original) (raw)

changeset: 99764:b729e7ae2747 parent: 99761:53271aa4d84c parent: 99763:3b7a7ea1214c user: Senthil Kumaran senthil@uthcode.com date: Sun Jan 03 00:45:05 2016 -0800 files: Doc/library/time.rst description: merge from 3.5 Issue21221 - Explain the usage of tm_isdst attribute of mktime, with valid values and meaning. Patch contributed by Andrew Scheller. diff -r 53271aa4d84c -r b729e7ae2747 Doc/library/time.rst --- a/Doc/library/time.rst Sat Jan 02 17:25:59 2016 -0500 +++ b/Doc/library/time.rst Sun Jan 03 00:45:05 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