mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-11-03 19:34:08 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

Patch #792338: Correct documentation for timetuple return type.

Browse source
This commit is contained in:
Martin v. Löwis 2003-09-04 18:29:53 +00:00
parent f5b93736a2
commit ef36537b81
1 changed files with 7 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

14
Doc/lib/libdatetime.tex
View file

@ -428,15 +428,15 @@ Instance methods:
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{timetuple}{} \begin{methoddesc}{timetuple}{}
Return a 9-element tuple of the form returned by Return a \class{time.struct_time} such as returned by
\function{time.localtime()}. The hours, minutes and seconds are \function{time.localtime()}. The hours, minutes and seconds are
0, and the DST flag is -1. 0, and the DST flag is -1.
\code{\var{d}.timetuple()} is equivalent to \code{\var{d}.timetuple()} is equivalent to
\code{(\var{d}.year, \var{d}.month, \var{d}.day, \code{time.struct_time((\var{d}.year, \var{d}.month, \var{d}.day,
0, 0, 0, 0, 0, 0,
\var{d}.weekday(), \var{d}.weekday(),
\var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1, \var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1,
-1)} -1))}
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{toordinal}{} \begin{methoddesc}{toordinal}{}
@ -858,14 +858,14 @@ Instance methods:
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{timetuple}{} \begin{methoddesc}{timetuple}{}
Return a 9-element tuple of the form returned by Return a \class{time.struct_time} such as returned by
\function{time.localtime()}. \function{time.localtime()}.
\code{\var{d}.timetuple()} is equivalent to \code{\var{d}.timetuple()} is equivalent to
\code{(\var{d}.year, \var{d}.month, \var{d}.day, \code{time.struct_time((\var{d}.year, \var{d}.month, \var{d}.day,
\var{d}.hour, \var{d}.minute, \var{d}.second, \var{d}.hour, \var{d}.minute, \var{d}.second,
\var{d}.weekday(), \var{d}.weekday(),
\var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1, \var{d}.toordinal() - date(\var{d}.year, 1, 1).toordinal() + 1,
dst)} dst))}
The \member{tm_isdst} flag of the result is set according to The \member{tm_isdst} flag of the result is set according to
the \method{dst()} method: \member{tzinfo} is \code{None} or the \method{dst()} method: \member{tzinfo} is \code{None} or
\method{dst()} returns \code{None}, \method{dst()} returns \code{None},
@ -881,7 +881,7 @@ Instance methods:
for a UTC time. for a UTC time.
If \var{d} is aware, \var{d} is normalized to UTC time, by subtracting If \var{d} is aware, \var{d} is normalized to UTC time, by subtracting
\code{\var{d}.utcoffset()}, and a timetuple for the \code{\var{d}.utcoffset()}, and a \class{time.struct_time} for the
normalized time is returned. \member{tm_isdst} is forced to 0. normalized time is returned. \member{tm_isdst} is forced to 0.
Note that the result's \member{tm_year} member may be Note that the result's \member{tm_year} member may be
\constant{MINYEAR}-1 or \constant{MAXYEAR}+1, if \var{d}.year was \constant{MINYEAR}-1 or \constant{MAXYEAR}+1, if \var{d}.year was