summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libdatetime.tex
diff options
context:
space:
mode:
authorTim Peters <tim.peters@gmail.com>2003-01-23 19:58:02 (GMT)
committerTim Peters <tim.peters@gmail.com>2003-01-23 19:58:02 (GMT)
commit10cadce41ec7b94aafc11b4f2c9cfb7587f5b81d (patch)
treea08fd27ddaa04db1b7cad9c552b08fd964e53a68 /Doc/lib/libdatetime.tex
parent250684ddd8223de98b5944d13e89a12673d0a51a (diff)
downloadcpython-10cadce41ec7b94aafc11b4f2c9cfb7587f5b81d.zip
cpython-10cadce41ec7b94aafc11b4f2c9cfb7587f5b81d.tar.gz
cpython-10cadce41ec7b94aafc11b4f2c9cfb7587f5b81d.tar.bz2
Reimplemented datetime.now() to be useful.
Diffstat (limited to 'Doc/lib/libdatetime.tex')
-rw-r--r--Doc/lib/libdatetime.tex22
1 files changed, 14 insertions, 8 deletions
diff --git a/Doc/lib/libdatetime.tex b/Doc/lib/libdatetime.tex
index 9133f1e..b890024 100644
--- a/Doc/lib/libdatetime.tex
+++ b/Doc/lib/libdatetime.tex
@@ -525,19 +525,25 @@ Other constructors, all class methods:
See also \method{now()}, \method{fromtimestamp()}.
\end{methoddesc}
-\begin{methoddesc}{now}{}
- Return the current local datetime. This is like \method{today()},
- but, if possible, supplies more precision than can be gotten from
- going through a \function{time.time()} timestamp (for example,
- this may be possible on platforms that supply the C
+\begin{methoddesc}{now(tz=None)}{}
+ Return the current local date and time. If optional argument
+ \var{tz} is \code{None} or not specified, this is like
+ \method{today()}, but, if possible, supplies more precision than can
+ be gotten from going through a \function{time.time()} timestamp (for
+ example, this may be possible on platforms supplying the C
\cfunction{gettimeofday()} function).
+
+ Else \var{tz} must be an instance of a class \class{tzinfo} subclass,
+ and the current date and time are translated to \var{tz}'s time
+ zone. In this case the result is equivalent to
+ \code{\var{tz}.fromutc(datetime.utcnow().replace(tzinfo=\var{tz})}.
See also \method{today()}, \method{utcnow()}.
\end{methoddesc}
\begin{methoddesc}{utcnow}{}
- Return the current UTC datetime, with \member{tzinfo} \code{None}.
- This is like \method{now()}, but
- returns the current UTC date and time.
+ Return the current UTC date and time, with \member{tzinfo} \code{None}.
+ This is like \method{now()}, but returns the current UTC date and time,
+ as a naive \class{datetime} object.
See also \method{now()}.
\end{methoddesc}