Commit 8cf94e60 authored by Guido van Rossum's avatar Guido van Rossum

Add mktime_tz(). Add () to a function reference in parsedate_tz().

parent 00455b77
...@@ -40,13 +40,21 @@ returned. ...@@ -40,13 +40,21 @@ returned.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{parsedate_tz}{date} \begin{funcdesc}{parsedate_tz}{date}
Performs the same function as \code{parsedate}, but returns either Performs the same function as \code{parsedate()}, but returns either
\code{None} or a 10-tuple; the first 9 elements make up a tuple that \code{None} or a 10-tuple; the first 9 elements make up a tuple that
can be passed directly to \code{time.mktime()}, and the tenth is the can be passed directly to \code{time.mktime()}, and the tenth is the
offset of the date's time zone from UTC (which is the official term offset of the date's time zone from UTC (which is the official term
for Greenwich Mean Time). for Greenwich Mean Time).
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{mktime_tz}{tuple}
Turn a 10-tuple as returned by \code{parsedate_tz()} into a UTC timestamp.
Minor deficiency: this first interprets the first 8 elements as a
local time and then compensates for the timezone difference;
this may yield a slight error around daylight savings time
switch dates. Not enough to worry about for common use.
\end{funcdesc}
\subsection{Message Objects} \subsection{Message Objects}
A \code{Message} instance has the following methods: A \code{Message} instance has the following methods:
......
...@@ -40,13 +40,21 @@ returned. ...@@ -40,13 +40,21 @@ returned.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{parsedate_tz}{date} \begin{funcdesc}{parsedate_tz}{date}
Performs the same function as \code{parsedate}, but returns either Performs the same function as \code{parsedate()}, but returns either
\code{None} or a 10-tuple; the first 9 elements make up a tuple that \code{None} or a 10-tuple; the first 9 elements make up a tuple that
can be passed directly to \code{time.mktime()}, and the tenth is the can be passed directly to \code{time.mktime()}, and the tenth is the
offset of the date's time zone from UTC (which is the official term offset of the date's time zone from UTC (which is the official term
for Greenwich Mean Time). for Greenwich Mean Time).
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{mktime_tz}{tuple}
Turn a 10-tuple as returned by \code{parsedate_tz()} into a UTC timestamp.
Minor deficiency: this first interprets the first 8 elements as a
local time and then compensates for the timezone difference;
this may yield a slight error around daylight savings time
switch dates. Not enough to worry about for common use.
\end{funcdesc}
\subsection{Message Objects} \subsection{Message Objects}
A \code{Message} instance has the following methods: A \code{Message} instance has the following methods:
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment