summaryrefslogtreecommitdiffstats
path: root/Doc/lib/libdatetime.tex
diff options
context:
space:
mode:
authorAndrew M. Kuchling <amk@amk.ca>2002-12-30 14:20:16 (GMT)
committerAndrew M. Kuchling <amk@amk.ca>2002-12-30 14:20:16 (GMT)
commitfa91858c6c6b1f51bf5aa2483f3e6df9c86dca41 (patch)
treecbb3d2988d22b8ac600c9c13718b41e8fbb8344d /Doc/lib/libdatetime.tex
parent63b482cefbb1b62d257e390b93dd94bc29c8b5fa (diff)
downloadcpython-fa91858c6c6b1f51bf5aa2483f3e6df9c86dca41.zip
cpython-fa91858c6c6b1f51bf5aa2483f3e6df9c86dca41.tar.gz
cpython-fa91858c6c6b1f51bf5aa2483f3e6df9c86dca41.tar.bz2
More markup additions
Diffstat (limited to 'Doc/lib/libdatetime.tex')
-rw-r--r--Doc/lib/libdatetime.tex420
1 files changed, 264 insertions, 156 deletions
diff --git a/Doc/lib/libdatetime.tex b/Doc/lib/libdatetime.tex
index ac71752..79653ba 100644
--- a/Doc/lib/libdatetime.tex
+++ b/Doc/lib/libdatetime.tex
@@ -147,9 +147,11 @@ between two dates or times.
and days, seconds and microseconds are then normalized so that the
representation is unique, with
- 0 <= microseconds < 1000000
- 0 <= seconds < 3600*24 (the number of seconds in one day)
- -999999999 <= days <= 999999999
+\begin{itemize}
+ \item \code{0 <= \var{microseconds} < 1000000}
+ \item \code{0 <= \var{seconds} < 3600*24} (the number of seconds in one day)
+ \item \code{-999999999 <= \var{days} <= 999999999}
+\end{itemize}
If any argument is a float, and there are fractional microseconds,
the fractional microseconds left over from all arguments are combined
@@ -174,11 +176,11 @@ between two dates or times.
Class attributes are:
\begin{memberdesc}{min}
- The most negative timedelta object, \code{timedelta(-999999999)}.
+ The most negative \class{timedelta} object, \code{timedelta(-999999999)}.
\end{memberdesc}
\begin{memberdesc}{max}
- The most positive timedelta object,
+ The most positive \class{timedelta} object,
timedelta(days=999999999, hours=23, minutes=59, seconds=59,
microseconds=999999)
\end{memberdesc}
@@ -189,7 +191,7 @@ Class attributes are:
\end{memberdesc}
Note that, because of normalization, timedelta.max > -timedelta.min.
--timedelta.max is not representable as a timedelta object.
+-timedelta.max is not representable as a \class{timedelta} object.
Instance attributes (read-only):
@@ -238,21 +240,21 @@ Supported operations:
\item
+timedelta -> timedelta
- Returns a timedelta object with the same value.
+ Returns a \class{timedelta} object with the same value.
\item
-timedelta -> timedelta
-t is equivalent to timedelta(-t.days, -t.seconds, -t.microseconds),
and to t*-1. This is exact, but may overflow (for example,
- -timedelta.max is not representable as a timedelta object).
+ -timedelta.max is not representable as a \class{timedelta} object).
\item
- abs(timedelta) -> timedelta
- abs(t) is equivalent to +t when t.days >= 0, and to -t when
- t.days < 0. This is exact, and cannot overflow.
+ \code{abs(timedelta) -> timedelta}:
+ \code{abs(t)} is equivalent to +t when \code{t.days >= 0}, and to -t when
+ \code{t.days < 0}. This is exact, and cannot overflow.
\item
- comparison of timedelta to timedelta; the timedelta representing
+ comparison of \class{timedelta} to timedelta; the \class{timedelta} representing
the smaller duration is considered to be the smaller timedelta
\item
@@ -262,7 +264,7 @@ Supported operations:
efficient pickling
\item
- in Boolean contexts, a timedelta object is considred to be true
+ in Boolean contexts, a \class{timedelta} object is considered to be true
if and only if it isn't equal to \code{timedelta(0)}
\end{itemize}
@@ -284,9 +286,9 @@ proleptic Gregorian ordinals and many other calendar systems.
following ranges:
\begin{itemize}
- \item MINYEAR <= \var{year} <= MAXYEAR
- \item 1 <= \var{month} <= 12
- \item 1 <= \var{day} <= number of days in the given month and year
+ \item \code{MINYEAR <= \var{year} <= MAXYEAR}
+ \item \code{1 <= \var{month} <= 12}
+ \item \code{1 <= \var{day} <= number of days in the given month and year}
\end{itemize}
If an argument outside those ranges is given, \exception{ValueError}
@@ -312,7 +314,7 @@ Other constructors, all class methods:
\begin{methoddesc}{fromordinal}{ordinal}
Return the date corresponding to the proleptic Gregorian ordinal,
where January 1 of year 1 has ordinal 1. \exception{ValueError}
- is raised unless 1 <= \var{ordinal} <= \code{date.max.toordinal()}. For any
+ is raised unless \code{1 <= \var{ordinal} <= date.max.toordinal()}. For any
date \var{d}, \code{date.fromordinal(\var{d}.toordinal()) == \var{d}}.
\end{methoddesc}
@@ -484,13 +486,13 @@ The year, month and day arguments are required. Arguments may be ints
or longs, in the following ranges:
\begin{itemize}
- \item \member{MINYEAR} <= \var{year} <= \member{MAXYEAR}
- \item 1 <= \var{month} <= 12
- \item 1 <= \var{day} <= number of days in the given month and year
- \item 0 <= \var{hour} < 24
- \item 0 <= \var{minute} < 60
- \item 0 <= \var{second} < 60
- \item 0 <= \var{microsecond} < 1000000
+ \item \code{\member{MINYEAR} <= \var{year} <= \member{MAXYEAR}}
+ \item \code{1 <= \var{month} <= 12}
+ \item \code{1 <= \var{day} <= number of days in the given month and year}
+ \item \code{0 <= \var{hour} < 24}
+ \item \code{0 <= \var{minute} < 60}
+ \item \code{0 <= \var{second} < 60}
+ \item \code{0 <= \var{microsecond} < 1000000}
\end{itemize}
If an argument outside those ranges is given,
@@ -560,28 +562,51 @@ Other constructors, all class methods:
Class attributes:
- .min
- The earliest representable datetime,
- datetime(MINYEAR, 1, 1).
+\begin{memberdesc}{min}
+ The earliest representable \class{datetime},
+ \code{datetime(MINYEAR, 1, 1)}.
+\end{memberdesc}
- .max
- The latest representable datetime,
- datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999).
+\begin{memberdesc}{max}
+ The latest representable \class{datetime},
+ \code{datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999)}.
+\end{memberdesc}
- .resolution
- The smallest possible difference between non-equal datetime
- objects, timedelta(microseconds=1).
+\begin{memberdesc}{resolution}
+ The smallest possible difference between non-equal \class{datetime}
+ objects, \code{timedelta(microseconds=1)}.
+\end{memberdesc}
Instance attributes (read-only):
- .year between \constant{MINYEAR} and \constant{MAXYEAR} inclusive
- .month between 1 and 12 inclusive
- .day between 1 and the number of days in the given month
- of the given year
- .hour in range(24)
- .minute in range(60)
- .second in range(60)
- .microsecond in range(1000000)
+\begin{memberdesc}{year}
+Between \constant{MINYEAR} and \constant{MAXYEAR} inclusive
+\end{memberdesc}
+
+\begin{memberdesc}{month}
+Between 1 and 12 inclusive
+\end{memberdesc}
+
+\begin{memberdesc}{day}
+Between 1 and the number of days in the given month
+ of the given year.
+\end{memberdesc}
+
+\begin{memberdesc}{hour}
+In \code{range(24)}.
+\end{memberdesc}
+
+\begin{memberdesc}{minute}
+In \code{range(60)}.
+\end{memberdesc}
+
+\begin{memberdesc}{second}
+In \code{range(60)}.
+\end{memberdesc}
+
+\begin{memberdesc}{microsecond}
+In \code{range(1000000)}.
+\end{memberdesc}
Supported operations:
@@ -625,22 +650,26 @@ Supported operations:
Instance methods:
- - date()
+\begin{methoddesc}{date}{}
Return \class{date} object with same year, month and day.
+\end{methoddesc}
- - time()
+\begin{methoddesc}{time}{}
Return time object with same hour, minute, second and microsecond.
+\end{methoddesc}
- - replace(year=, month=, day=, hour=, minute=, second=, microsecond=)
+\begin{methoddesc}{replace}{year=, month=, day=, hour=, minute=, second=, microsecond=}
Return a datetime with the same value, except for those fields given
new values by whichever keyword arguments are specified.
+\end{methoddesc}
- - astimezone(tz)
+\begin{methoddesc}{astimezone}{tz}
Return a \class{datetimetz} with the same date and time fields, and
with \member{tzinfo} member \var{tz}. \var{tz} must be \code{None},
or an instance of a \class{tzinfo} subclass.
+\end{methoddesc}
- - timetuple()
+\begin{methoddesc}{timetuple}{}
Return a 9-element tuple of the form returned by
\function{time.localtime()}.
The DST flag is -1. \code{d.timetuple()} is equivalent to
@@ -649,26 +678,31 @@ Instance methods:
d.weekday(), \# 0 is Monday
d.toordinal() - date(d.year, 1, 1).toordinal() + 1, \# day of year
-1)
+\end{methoddesc}
- - toordinal()
+\begin{methoddesc}{toordinal}{}
Return the proleptic Gregorian ordinal of the date. The same as
\method{date.toordinal()}.
+\end{methoddesc}
- - weekday()
+\begin{methoddesc}{weekday}{}
Return the day of the week as an integer, where Monday is 0 and
Sunday is 6. The same as \method{date.weekday()}.
See also \method{isoweekday()}.
+\end{methoddesc}
- - isoweekday()
+\begin{methoddesc}{isoweekday}{}
Return the day of the week as an integer, where Monday is 1 and
Sunday is 7. The same as \method{date.isoweekday()}.
See also \method{weekday()}, \method{isocalendar()}.
+\end{methoddesc}
- - isocalendar()
+\begin{methoddesc}{isocalendar}{}
Return a 3-tuple, (ISO year, ISO week number, ISO weekday). The
same as \method{date.isocalendar()}.
+\end{methoddesc}
- - isoformat(sep='T')
+\begin{methoddesc}{isoformat}{sep='T'}
Return a string representing the date and time in ISO 8601 format,
YYYY-MM-DDTHH:MM:SS.mmmmmm
or, if self.microsecond is 0,
@@ -678,12 +712,14 @@ Instance methods:
of the result. For example,
datetime(2002, 12, 4, 1, 2, 3, 4).isoformat(' ') ==
'2002-12-04 01:02:03.000004'
+\end{methoddesc}
- - __str__()
+\begin{methoddesc}{__str__}{}
For a \class{datetime} instance \var{d}, \code{str(\var{d})} is
equivalent to \code{\var{d}.isoformat(' ')}.
+\end{methoddesc}
- - ctime()
+\begin{methoddesc}{ctime}{}
Return a string representing the date, for example
datetime(2002, 12, 4, 20, 30, 40).ctime() == 'Wed Dec 4 20:30:40 2002'.
\code{d.ctime()} is equivalent to
@@ -692,11 +728,13 @@ Instance methods:
\function{time.ctime()} invokes, but which
\method{datetime.ctime()} does not invoke) conforms to the C
standard.
+\end{methoddesc}
- - strftime(format)
+\begin{methoddesc}{strftime}{format}
Return a string representing the date and time, controlled by an
explicit format string. See the section on \method{strftime()}
behavior.
+\end{methoddesc}
\subsection{\class{time} \label{datetime-time}}
@@ -721,23 +759,34 @@ Constructor:
Class attributes:
- .min
- The earliest representable time, time(0, 0, 0, 0).
+\begin{memberdesc}{min}
+ The earliest representable \class{time}, \code{time(0, 0, 0, 0)}.
+\end{memberdesc}
- .max
- The latest representable time, time(23, 59, 59, 999999).
+\begin{memberdesc}{max}
+ The latest representable \class{time}, \code{time(23, 59, 59, 999999)}.
+\end{memberdesc}
- .resolution
- The smallest possible difference between non-equal time
- objects, timedelta(microseconds=1), although note that
- arithmetic on time objects is not supported.
+\begin{memberdesc}{resolution}
+ The smallest possible difference between non-equal \class{time}
+ objects, \code{timedelta(microseconds=1)}, although note that
+ arithmetic on \class{time} objects is not supported.
+\end{memberdesc}
Instance attributes (read-only):
- .hour in range(24)
- .minute in range(60)
- .second in range(60)
- .microsecond in range(1000000)
+\begin{memberdesc}{hour}
+In \code{range(24)}.
+\end{memberdesc}
+\begin{memberdesc}{minute}
+In \code{range(60)}.
+\end{memberdesc}
+\begin{memberdesc}{second}
+In \code{range(60)}.
+\end{memberdesc}
+\begin{memberdesc}{microsecond}
+In \code{range(1000000)}.
+\end{memberdesc}
Supported operations:
@@ -759,23 +808,27 @@ Supported operations:
Instance methods:
- - replace(hour=, minute=, second=, microsecond=)
+\begin{methoddesc}{replace}{hour=, minute=, second=, microsecond=}
Return a time with the same value, except for those fields given
new values by whichever keyword arguments are specified.
+\end{methoddesc}
- - isoformat()
+\begin{methoddesc}{isoformat}{}
Return a string representing the time in ISO 8601 format,
HH:MM:SS.mmmmmm
or, if self.microsecond is 0
HH:MM:SS
+\end{methoddesc}
- - __str__()
+\begin{methoddesc}{__str__}{}
For a time \var{t}, \code{str(\var{t})} is equivalent to
\code{\var{t}.isoformat()}.
+\end{methoddesc}
- - strftime(format)
+\begin{methoddesc}{strftime}{format}
Return a string representing the time, controlled by an explicit
format string. See the section on \method{strftime()} behavior.
+\end{methoddesc}
\subsection{\class{tzinfo} \label{datetime-tzinfo}}
@@ -808,7 +861,7 @@ or \class{timetz} object, passing itself as the argument. A
argument of \code{None} or of type \class{timetz} or
\class{datetimetz}.
- - utcoffset(dt)
+\begin{methoddesc}{utcoffset}{dt}
Return offset of local time from UTC, in minutes east of UTC. If
local time is west of UTC, this should be negative. Note that this
is intended to be the total offset from UTC; for example, if a
@@ -819,8 +872,9 @@ argument of \code{None} or of type \class{timetz} or
the magnitude of the offset must be less than one day), or a
\class{timedelta} object representing a whole number of minutes
in the same range.
+\end{methoddesc}
- - tzname(dt)
+\begin{methoddesc}{tzname}{dt}
Return the timezone name corresponding to the \class{datetime} represented
by dt, as a string. Nothing about string names is defined by the
\module{datetime} module, and there's no requirement that it mean anything
@@ -830,8 +884,9 @@ argument of \code{None} or of type \class{timetz} or
rather than a fixed string primarily because some \class{tzinfo} objects
will wish to return different names depending on the specific value
of dt passed, especially if the \class{tzinfo} class is accounting for DST.
+\end{methoddesc}
- - dst(dt)
+\begin{methoddesc}{dst}{dt}
Return the DST offset, in minutes east of UTC, or \code{None} if
DST information isn't known. Return 0 if DST is not in effect.
If DST is in effect, return the offset as an integer or
@@ -843,6 +898,7 @@ argument of \code{None} or of type \class{timetz} or
example, \method{datetimetz.timetuple()} calls its \member{tzinfo}
member's \method{dst()} method to determine how the
\member{tm_isdst} flag should be set.
+\end{methoddesc}
Example \class{tzinfo} classes:
@@ -856,32 +912,38 @@ particular day, and subject to adjustment via a \class{tzinfo} object.
Constructor:
- time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None)
+\begin{funcdesc}{time}{hour=0, minute=0, second=0, microsecond=0, tzinfo=None}
All arguments are optional. \var{tzinfo} may be \code{None}, or
an instance of a \class{tzinfo} subclass. The remaining arguments
may be ints or longs, in the following ranges:
- 0 <= hour < 24
- 0 <= minute < 60
- 0 <= second < 60
- 0 <= microsecond < 1000000
+\begin{itemize}
+ \item \code{0 <= \var{hour} < 24}
+ \item \code{0 <= \var{minute} < 60}
+ \item \code{0 <= \var{second} < 60}
+ \item \code{0 <= \var{microsecond} < 1000000}.
+\end{itemize}
If an argument outside those ranges is given,
\exception{ValueError} is raised.
+\end{funcdesc}
Class attributes:
- .min
- The earliest representable time, timetz(0, 0, 0, 0).
+\begin{memberdesc}{min}
+ The earliest representable time, \code{timetz(0, 0, 0, 0)}.
+\end{memberdesc}
- .max
- The latest representable time, timetz(23, 59, 59, 999999).
+\begin{memberdesc}{max}
+ The latest representable time, \code{timetz(23, 59, 59, 999999)}.
+\end{memberdesc}
- .resolution
- The smallest possible difference between non-equal timetz
- objects, timedelta(microseconds=1), although note that
+\begin{memberdesc}{resolution}
+ The smallest possible difference between non-equal \class{timetz}
+ objects, \code{timedelta(microseconds=1)}, although note that
arithmetic on \class{timetz} objects is not supported.
+\end{memberdesc}
Instance attributes (read-only):
@@ -899,7 +961,7 @@ Supported operations:
\item
comparison of \class{timetz} to \class{time} or \class{timetz},
where \var{a} is considered less than \var{b} when \var{a} precedes
- \var{b} in time. If one comparand is naive and the other is aware,
+ \var{b} in time. If one comparand is {\naive} and the other is aware,
\exception{TypeError} is raised. If both comparands are aware, and
have the same \member{tzinfo} member, the common \member{tzinfo}
member is ignored and the base times are compared. If both
@@ -922,44 +984,51 @@ Supported operations:
Instance methods:
- - replace(hour=, minute=, second=, microsecond=, tzinfo=)
- Return a timetz with the same value, except for those fields given
+\begin{methoddesc}{replace}(hour=, minute=, second=, microsecond=, tzinfo=)
+ Return a \class{timetz} with the same value, except for those fields given
new values by whichever keyword arguments are specified. Note that
- \code{tzinfo=None} can be specified to create a naive timetz from an
- aware timetz.
+ \code{tzinfo=None} can be specified to create a {\naive} \class{timetz} from an
+ aware \class{timetz}.
+\end{methoddesc}
- - isoformat()
+\begin{methoddesc}{isoformat}{}
Return a string representing the time in ISO 8601 format,
HH:MM:SS.mmmmmm
- or, if self.microsecond is 0
+ or, if self.microsecond is 0,
HH:MM:SS
If \method{utcoffset()} does not return \code{None}, a 6-character
string is appended, giving the UTC offset in (signed) hours and
minutes:
HH:MM:SS.mmmmmm+HH:MM
- or, if self.microsecond is 0
+ or, if self.microsecond is 0,
HH:MM:SS+HH:MM
+\end{methoddesc}
- - __str__()
+\begin{methoddesc}{__str__}{}
For a \class{timetz} \var{t}, \code{str(\var{t})} is equivalent to
\code{\var{t}.isoformat()}.
+\end{methoddesc}
- - strftime(format)
+\begin{methoddesc}{strftime}{format}
Return a string representing the time, controlled by an explicit
format string. See the section on \method{strftime()} behavior.
+\end{methoddesc}
- - utcoffset()
+\begin{methoddesc}{utcoffset}{}
If \member{tzinfo} is \code{None}, returns \code{None}, else
\code{tzinfo.utcoffset(self)} converted to a \class{timedelta}
object.
+\end{methoddesc}
- - tzname():
+\begin{methoddesc}{tzname}{}
If \member{tzinfo} is \code{None}, returns \code{None}, else
\code{tzinfo.tzname(self)}.
+\end{methoddesc}
- - dst()
+\begin{methoddesc}{dst}{}
If \member{tzinfo} is \code{None}, returns \code{None}, else
\code{tzinfo.dst(self)} converted to a \class{timedelta} object.
+\end{methoddesc}
@@ -975,74 +1044,99 @@ from a \class{date} object and a \class{timetz} object.
Constructor:
- datetimetz(year, month, day,
- hour=0, minute=0, second=0, microsecond=0, tzinfo=None)
+\begin{funcdesc}{datetimetz}{year, month, day,
+ hour=0, minute=0, second=0, microsecond=0, tzinfo=None}
The year, month and day arguments are required. \var{tzinfo} may
be \code{None}, or an instance of a \class{tzinfo} subclass. The
remaining arguments may be ints or longs, in the following ranges:
- MINYEAR <= year <= MAXYEAR
- 1 <= month <= 12
- 1 <= day <= number of days in the given month and year
- 0 <= hour < 24
- 0 <= minute < 60
- 0 <= second < 60
- 0 <= microsecond < 1000000
+\begin{itemize}
+ \item \code{MINYEAR <= \var{year} <= MAXYEAR}
+ \item \code{1 <= \var{month} <= 12}
+ \item \code{1 <= \var{day} <= number of days in the given month and year}
+ \item \code{0 <= \var{hour} < 24}
+ \item \code{0 <= \var{minute} < 60}
+ \item \code{0 <= \var{second} < 60}
+ \item \code{0 <= \var{microsecond} < 1000000}
+\end{itemize}
If an argument outside those ranges is given,
\exception{ValueError} is raised.
+\end{funcdesc}
Other constructors (class methods):
- - today()
- utcnow()
- utcfromtimestamp(timestamp)
- fromordinal(ordinal)
+\begin{funcdesc}{today}{}
+ \methodline{utcnow}{}
+ \methodline{utcfromtimestamp}{timestamp}
+ \methodline{fromordinal}{ordinal}
These are the same as the \class{datetime} class methods of the
same names, except that they construct a \class{datetimetz}
object, with tzinfo \code{None}.
+\end{funcdesc}
- - now([tzinfo=None])
- fromtimestamp(timestamp[, tzinfo=None])
+\begin{funcdesc}{now}{\optional{tzinfo=None}}
+ \methodline{fromtimestamp}{timestamp\optional{, tzinfo=None}}
These are the same as the \class{datetime} class methods of the same names,
except that they accept an additional, optional tzinfo argument, and
construct a \class{datetimetz} object with that \class{tzinfo} object attached.
+\end{funcdesc}
- - combine(date, time)
+\begin{funcdesc}{combine}{date, time}
This is the same as \method{datetime.combine()}, except that it constructs
a \class{datetimetz} object, and, if the time object is of type timetz,
the \class{datetimetz} object has the same \class{tzinfo} object as the time object.
+\end{funcdesc}
Class attributes:
- .min
- The earliest representable datetimetz,
- datetimetz(MINYEAR, 1, 1).
+\begin{memberdesc}{min}
+ The earliest representable \class{datetimetz},
+ \code{datetimetz(MINYEAR, 1, 1)}.
+\end{memberdesc}
- .max
- The latest representable datetime,
- datetimetz(MAXYEAR, 12, 31, 23, 59, 59, 999999).
+\begin{memberdesc}{max}
+ The latest representable \class{datetime},
+ \code{datetimetz(MAXYEAR, 12, 31, 23, 59, 59, 999999)}.
+\end{memberdesc}
- .resolution
- The smallest possible difference between non-equal datetimetz
- objects, timedelta(microseconds=1).
+\begin{memberdesc}{resolution}
+ The smallest possible difference between non-equal \class{datetimetz}
+ objects, \code{timedelta(microseconds=1)}.
+\end{memberdesc}
-Instance attributes (read-only):
+Instance attributes, all read-only:
- .year between MINYEAR and MAXYEAR inclusive
- .month between 1 and 12 inclusive
- .day between 1 and the number of days in the given month
+\begin{memberdesc}{year}
+Between MINYEAR and MAXYEAR inclusive
+\end{memberdesc}
+\begin{memberdesc}{month}
+Between 1 and 12 inclusive
+\end{memberdesc}
+\begin{memberdesc}{day}
+Between 1 and the number of days in the given month
of the given year
- .hour in range(24)
- .minute in range(60)
- .second in range(60)
- .microsecond in range(1000000)
- .tzinfo the object passed as the \var{tzinfo} argument to
+\end{memberdesc}
+\begin{memberdesc}{hour}
+In \code{range(24)}.
+\end{memberdesc}
+\begin{memberdesc}{minute}
+In \code{range(60)}.
+\end{memberdesc}
+\begin{memberdesc}{second}
+In \code{range(60)}.
+\end{memberdesc}
+\begin{memberdesc}{microsecond}
+In \code{range(1000000)}.
+\end{memberdesc}
+\begin{memberdesc}{tzinfo}
+The object passed as the \var{tzinfo} argument to
the \class{datetimetz} constructor, or \code{None}
if none was passed.
+\end{memberdesc}
Supported operations:
@@ -1105,30 +1199,33 @@ Supported operations:
Instance methods:
- - date()
- time()
- toordinal()
- weekday()
- isoweekday()
- isocalendar()
- ctime()
- __str__()
- strftime(format)
-
- These are the same as the \class{datetime} methods of the same names.
+\begin{methoddesc}{date}{}
+ \methodline{time}{}
+ \methodline{toordinal}{}
+ \methodline{weekday}{}
+ \methodline{isoweekday}{}
+ \methodline{isocalendar}{}
+ \methodline{ctime}{}
+ \methodline{__str__}{}
+ \methodline{strftime}{format}
+
+These are the same as the \class{datetime} methods of the same names.
+\end{methoddesc}
- - timetz()
+\begin{methoddesc}{timetz}{}
Return \class{timetz} object with same hour, minute, second, microsecond,
and tzinfo.
+\end{methoddesc}
- - replace(year=, month=, day=, hour=, minute=, second=, microsecond=,
- tzinfo=)
+\begin{methoddesc}{replace}{year=, month=, day=, hour=, minute=, second=, microsecond=,
+ tzinfo=}
Return a datetimetz with the same value, except for those fields given
new values by whichever keyword arguments are specified. Note that
\code{tzinfo=None} can be specified to create a naive datetimetz from
an aware datetimetz.
+\end{methoddesc}
- - astimezone(tz)
+\begin{methoddesc}{astimezone}{tz}
Return a \class{datetimetz} with new tzinfo member \var{tz}. \var{tz}
must be \code{None}, or an instance of a \class{tzinfo} subclass. If
\var{tz} is \code{None}, self is naive, or
@@ -1143,32 +1240,37 @@ Instance methods:
\begin{verbatim}
(self - (self.utcoffset() - tz.utcoffset(self)).replace(tzinfo=tz)
\end{verbatim}
- where the result of \code{tz.uctcoffset(self)} is converted to a
+ where the result of \code{tz.utcoffset(self)} is converted to a
\class{timedelta} if it's an integer.
+\end{methoddesc}
- - utcoffset()
+\begin{methoddesc}{utcoffset}{}
If \member{tzinfo} is \code{None}, returns \code{None}, else
\code{tzinfo.utcoffset(self)} converted to a \class{timedelta}
object.
+\end{methoddesc}
- - tzname()
+\begin{methoddesc}{tzname}{}
If \member{tzinfo} is \code{None}, returns \code{None}, else
- \code{tzinfo.tzname(self)}.
+ returns \code{tzinfo.tzname(self)}.
+\end{methoddesc}
- - dst()
+\begin{methoddesc}{dst}{}
If \member{tzinfo} is \code{None}, returns \code{None}, else
\code{tzinfo.dst(self)} converted to a \class{timedelta}
object.
+\end{methoddesc}
- - timetuple()
+\begin{methoddesc}{timetuple}{}
Like \function{datetime.timetuple()}, but sets the
\member{tm_isdst} flag according to the \method{dst()} method: if
\method{dst()} returns \code{None}, \member{tm_isdst} is set to
\code{-1}; else if \method{dst()} returns a non-zero value,
\member{tm_isdst} is set to \code{1}; else \code{tm_isdst} is set
to \code{0}.
+\end{methoddesc}
- - utctimetuple()
+\begin{methoddesc}{utctimetuple}{}
If \class{datetimetz} instance \var{d} is \naive, this is the same as
\code{\var{d}.timetuple()} except that \member{tm_isdst} is forced to 0
regardless of what \code{d.dst()} returns. DST is never in effect
@@ -1181,8 +1283,9 @@ Instance methods:
\constant{MINYEAR}-1 or \constant{MAXYEAR}+1, if \var{d}.year was
\code{MINYEAR} or \code{MAXYEAR} and UTC adjustment spills over a
year boundary.
+\end{methoddesc}
- - isoformat(sep='T')
+\begin{methoddesc}{isoformat}{sep='T'}
Return a string representing the date and time in ISO 8601 format,
YYYY-MM-DDTHH:MM:SS.mmmmmm
or, if \member{microsecond} is 0,
@@ -1207,6 +1310,7 @@ Instance methods:
>>> datetimetz(2002, 12, 25, tzinfo=TZ()).isoformat(' ')
'2002-12-25 00:00:00-06:39'
\end{verbatim}
+\end{methoddesc}
\code{str(\var{d})} is equivalent to \code{\var{d}.isoformat(' ')}.
@@ -1247,7 +1351,7 @@ For an aware object:
\item[\code{\%Z}]
If \method{tzname()} returns \code{None}, \code{\%Z} is replaced
- by an empty string. Else \code{\%Z} is replaced by the returned
+ by an empty string. Otherwise \code{\%Z} is replaced by the returned
value, which must be a string.
\end{itemize}
@@ -1264,6 +1368,8 @@ varies across platforms. Regardless of platform, years before 1900
cannot be used.
+\begin{comment}
+
\subsection{C API}
Struct typedefs:
@@ -1320,3 +1426,5 @@ return ints:
PyDateTime_TIME_GET_MINUTE(o)
PyDateTime_TIME_GET_SECOND(o)
PyDateTime_TIME_GET_MICROSECOND(o)
+
+\end{comment}