From ef1b50de6c6113bf47719634a22eabe3a2635ef8 Mon Sep 17 00:00:00 2001
From: Skip Montanaro <skip@pobox.com>
Date: Tue, 6 Dec 2005 21:00:47 +0000
Subject: add common usage example

---
 Doc/lib/libdatetime.tex | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/Doc/lib/libdatetime.tex b/Doc/lib/libdatetime.tex
index cbda4c4..4bba553 100644
--- a/Doc/lib/libdatetime.tex
+++ b/Doc/lib/libdatetime.tex
@@ -1419,3 +1419,20 @@ C standard added additional format codes.
 The exact range of years for which \method{strftime()} works also
 varies across platforms.  Regardless of platform, years before 1900
 cannot be used.
+
+\subsection{Examples}
+
+\subsubsection{Creating Datetime Objects from Formatted Strings}
+
+The \class{datetime} class does not directly support parsing formatted time
+strings.  You can use \function{time.strptime} to do the parsing and create
+a \class{datetime} object from the tuple it returns:
+
+\begin{verbatim}
+>>> s = "2005-12-06T12:13:14"
+>>> from datetime import datetime
+>>> from time import strptime
+>>> datetime(*strptime(s, "%Y-%m-%dT%H:%M:%S")[0:6])
+datetime.datetime(2005, 12, 6, 12, 13, 14)
+\end{verbatim}
+
-- 
cgit v0.12