[Python-checkins] python/dist/src/Doc/lib libdatetime.tex,1.12,1.13

2002年12月30日 12:01:27 -0800

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]