summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1998-02-18 05:09:14 (GMT)
committerGuido van Rossum <guido@python.org>1998-02-18 05:09:14 (GMT)
commit8cf94e608ee430fe82dd4a48f52392cb56e8bd7f (patch)
tree12cc9c343a1f429953159e6f1a99def004a6921f /Doc
parent00455b77a66f78679f41e2b33955a439cb66316b (diff)
downloadcpython-8cf94e608ee430fe82dd4a48f52392cb56e8bd7f.zip
cpython-8cf94e608ee430fe82dd4a48f52392cb56e8bd7f.tar.gz
cpython-8cf94e608ee430fe82dd4a48f52392cb56e8bd7f.tar.bz2
Add mktime_tz(). Add () to a function reference in parsedate_tz().
Diffstat (limited to 'Doc')
-rw-r--r--Doc/lib/librfc822.tex10
-rw-r--r--Doc/librfc822.tex10
2 files changed, 18 insertions, 2 deletions
diff --git a/Doc/lib/librfc822.tex b/Doc/lib/librfc822.tex
index 1374755..4e65e91 100644
--- a/Doc/lib/librfc822.tex
+++ b/Doc/lib/librfc822.tex
@@ -40,13 +40,21 @@ returned.
\end{funcdesc}
\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
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
for Greenwich Mean Time).
\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}
A \code{Message} instance has the following methods:
diff --git a/Doc/librfc822.tex b/Doc/librfc822.tex
index 1374755..4e65e91 100644
--- a/Doc/librfc822.tex
+++ b/Doc/librfc822.tex
@@ -40,13 +40,21 @@ returned.
\end{funcdesc}
\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
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
for Greenwich Mean Time).
\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}
A \code{Message} instance has the following methods: