Update of /cvsroot/python/python/dist/src/Doc/lib
In directory sc8-pr-cvs1:/tmp/cvs-serv4553
Modified Files:
libdatetime.tex
Log Message:
Added markup upto line 233.
Index: libdatetime.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libdatetime.tex,v
retrieving revision 1.12
retrieving revision 1.13
diff -C2 -d -r1.12 -r1.13
*** libdatetime.tex 30 Dec 2002 14:20:16 -0000 1.12
--- libdatetime.tex 30 Dec 2002 20:01:24 -0000 1.13
***************
*** 9,12 ****
--- 9,15 ----
\sectionauthor{Tim Peters}{tim@zope.com}
\sectionauthor{A.M. Kuchling}{amk@amk.ca}
+ \sectionauthor{Raymond D. Hettinger}{python@rcn.com}
+
+ \versionadded{2.3}
\newcommand{\Naive}{Na\"ive}
***************
*** 51,54 ****
--- 54,61 ----
\end{datadesc}
+ \begin{seealso}
+ \seemodule{calendar}{General calandar related functions.}
+ \seemodule{time}{Time access and conversions.}
+ \end{seealso}
\subsection{Available Types}
***************
*** 126,147 ****
\end{verbatim}
! \subsection{\class{timedelta} \label{datetime-timedelta}}
A \class{timedelta} object represents a duration, the difference
between two dates or times.
- \begin{funcdesc}{timedelta}{days=0, seconds=0, microseconds=0,
- milliseconds=0, minutes=0, hours=0, weeks=0}
-
All arguments are optional. Arguments may be ints, longs, or floats,
and may be positive or negative.
! Only days, seconds and microseconds are stored internally. Arguments
! are converted to those units:
A millisecond is converted to 1000 microseconds.
A minute is converted to 60 seconds.
An hour is converted to 3600 seconds.
A week is converted to 7 days.
and days, seconds and microseconds are then normalized so that the
--- 133,155 ----
\end{verbatim}
! \subsection{\class{timedelta} Objects \label{datetime-timedelta}}
+ \begin{classdesc}{timedelta}{days=0, seconds=0, microseconds=0,
+ milliseconds=0, minutes=0, hours=0, weeks=0}
A \class{timedelta} object represents a duration, the difference
between two dates or times.
All arguments are optional. Arguments may be ints, longs, or floats,
and may be positive or negative.
! Only \var{days}, \var{seconds} and \var{microseconds} are stored
! internally. Arguments are converted to those units:
+ \begin{verbatim}
A millisecond is converted to 1000 microseconds.
A minute is converted to 60 seconds.
An hour is converted to 3600 seconds.
A week is converted to 7 days.
+ \end{verbatim}
and days, seconds and microseconds are then normalized so that the
***************
*** 172,193 ****
\end{verbatim}
! \end{funcdesc}
Class attributes are:
! \begin{memberdesc}{min}
! The most negative \class{timedelta} object, \code{timedelta(-999999999)}.
! \end{memberdesc}
!
! \begin{memberdesc}{max}
! The most positive \class{timedelta} object,
timedelta(days=999999999, hours=23, minutes=59, seconds=59,
! microseconds=999999)
! \end{memberdesc}
!
! \begin{memberdesc}{resolution}
! The smallest possible difference between non-equal timedelta
! objects, \code{timedelta(microseconds=1)}.
! \end{memberdesc}
Note that, because of normalization, timedelta.max > -timedelta.min.
--- 180,196 ----
\end{verbatim}
! \end{classdesc}
Class attributes are:
! \begin{tableii}{c|l}{code}{Attribute}{Value}
! \lineii{min}{The most negative \class{timedelta} object,
! \code{timedelta(-999999999)}}
! \lineii{max}{The most positive \class{timedelta} object,
timedelta(days=999999999, hours=23, minutes=59, seconds=59,
! microseconds=999999)}
! \lineii{resolution}{The smallest possible difference between non-equal
! \class{timedelta} objects, \code{timedelta(microseconds=1)}}
! \end{tableii}
Note that, because of normalization, timedelta.max > -timedelta.min.
***************
*** 196,238 ****
Instance attributes (read-only):
! \begin{memberdesc}{days}
! Between -999999999 and 999999999 inclusive.
! \end{memberdesc}
! \begin{memberdesc}{seconds}
! Between 0 and 86399 inclusive.
! \end{memberdesc}
! \begin{memberdesc}{microseconds}
! Between 0 and 999999 inclusive.
! \end{memberdesc}
Supported operations:
! \begin{itemize}
! \item
! timedelta + timedelta -> timedelta
! This is exact, but may overflow. After
! t1 = t2 + t3
! t1-t2 == t3 and t1-t3 == t2 are true.
! \item
! timedelta - timedelta -> timedelta
! This is exact, but may overflow. After
! t1 = t2 - t3
! t2 == t1 + t3 is true.
- \item
- timedelta * (int or long) -> timedelta
- (int or long) * timedelta -> timedelta
- This is exact, but may overflow. After
- t1 = t2 * i
- t1 // i == t2 is true, provided i != 0. In general,
- t * i == t * (i-1) + t
- is true.
- \item
- timedelta // (int or long) -> timedelta
- The floor is computed and the remainder (if any) is thrown away.
- Division by 0 raises \exception{ZeroDivisionError}.
\item
certain additions and subtractions with date, datetime, and datimetz
--- 199,237 ----
Instance attributes (read-only):
! \begin{tableii}{c|l}{code}{Attribute}{Value}
! \lineii{days}{Between -999999999 and 999999999 inclusive}
! \lineii{seconds}{Between 0 and 86399 inclusive}
! \lineii{microseconds}{Between 0 and 999999 inclusive}
! \end{tableii}
Supported operations:
! \begin{tableiii}{c|l|c}{code}{Operation}{Result}{Notes}
! \lineii{t1 = t2 + t3}{Sum of t2 and t3.
! Afterwards t1-t2 == t3 and t1-t3 == t2 are true.}{(1)}
! \lineii{t1 = t2 - t3}{Difference of t2 and t3. Afterwards t1 = t2 - t3 and
! t2 == t1 + t3 are true.}{(1)}
! \lineii{t1 = t2 * i or t1 = i * t2}{Delta multiplied by an integer or long.
! Afterwards t1 // i == t2 is true, provided i != 0.
! In general, t1 * i == t1 * (i-1) + t1 is true.}{(1)}
! \lineii{t1 = t2 // i}{The floor is computed and the remainder (if any) is
! thrown away.}{(2)}
!
! \end{tableii}
! \noindent
! Notes:
! \begin{description}
! \item[(1)]
! This is exact, but may overflow.
!
! \item[(2)]
! Division by 0 raises \exception{ZeroDivisionError}.
! \end{description}
+
+ \begin{itemize}
\item
certain additions and subtractions with date, datetime, and datimetz
***************
*** 270,274 ****
! \subsection{\class{date} \label{datetime-date}}
A \class{date} object represents a date (year, month and day) in an idealized
--- 269,273 ----
! \subsection{\class{date} Objects \label{datetime-date}}
A \class{date} object represents a date (year, month and day) in an idealized
***************
*** 472,476 ****
! \subsection{\class{datetime} \label{datetime-datetime}}
A \class{datetime} object is a single object containing all the
--- 471,475 ----
! \subsection{\class{datetime} Objects \label{datetime-datetime}}
A \class{datetime} object is a single object containing all the
***************
*** 738,742 ****
! \subsection{\class{time} \label{datetime-time}}
A time object represents an idealized time of day, independent of day
--- 737,741 ----
! \subsection{\class{time} Objects \label{datetime-time}}
A time object represents an idealized time of day, independent of day
***************
*** 832,836 ****
! \subsection{\class{tzinfo} \label{datetime-tzinfo}}
\class{tzinfo} is an abstract base clase, meaning that this class
--- 831,835 ----
! \subsection{\class{tzinfo} Objects \label{datetime-tzinfo}}
\class{tzinfo} is an abstract base clase, meaning that this class
***************
*** 906,910 ****
! \subsection{\class{timetz} \label{datetime-timetz}}
A time object represents a (local) time of day, independent of any
--- 905,909 ----
! \subsection{\class{timetz} Objects \label{datetime-timetz}}
A time object represents a (local) time of day, independent of any
***************
*** 1033,1037 ****
! \subsection{ \class{datetimetz} \label{datetime-datetimetz}}
\begin{notice}[warning]
--- 1032,1036 ----
! \subsection{ \class{datetimetz} Objects \label{datetime-datetimetz}}
\begin{notice}[warning]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4