Removed the now-untrue (or soon-to-be untrue) part of the astimezone()

docs.  Replaced it with an XXX block, because the hoped-for treatment
of DST endcases remains unclear (Guido doesn't really like raising an
exception when it's impossible to deliver a correct result, but so
far I have no way in hand to consistently deliver a defined incorrect
result either).
This commit is contained in:
Tim Peters 2002-12-31 16:01:47 +00:00
parent 3f0b542f25
commit 9532298c82
1 changed files with 7 additions and 10 deletions

View File

@ -208,7 +208,7 @@ Supported operations:
\begin{tableiii}{c|l|c}{code}{Operation}{Result}{Notes} \begin{tableiii}{c|l|c}{code}{Operation}{Result}{Notes}
\lineiii{\var{t1} = \var{t2} + \var{t3}} \lineiii{\var{t1} = \var{t2} + \var{t3}}
{Sum of \var{t2} and \var{t3}. {Sum of \var{t2} and \var{t3}.
Afterwards \var{t1}-\var{t2} == \var{t3} and \var{t1}-\var{t3} Afterwards \var{t1}-\var{t2} == \var{t3} and \var{t1}-\var{t3}
== \var{t2} are true.} == \var{t2} are true.}
{(1)} {(1)}
@ -231,13 +231,13 @@ Supported operations:
\lineiii{-\var{t1}} \lineiii{-\var{t1}}
{equivalent to \class{timedelta}(-\var{t1.days}, -\var{t1.seconds}, {equivalent to \class{timedelta}(-\var{t1.days}, -\var{t1.seconds},
-\var{t1.microseconds}),and to \var{t1}* -1.} -\var{t1.microseconds}),and to \var{t1}* -1.}
{(1)(3)} {(1)(3)}
\lineiii{abs(\var{t})} \lineiii{abs(\var{t})}
{equivalent to +\var{t} when \code{t.days >= 0}, and to -\var{t} when {equivalent to +\var{t} when \code{t.days >= 0}, and to -\var{t} when
\code{t.days < 0}.} \code{t.days < 0}.}
{(1)} {(1)}
\end{tableiii} \end{tableiii}
\noindent \noindent
Notes: Notes:
@ -1258,13 +1258,10 @@ These are the same as the \class{datetime} methods of the same names.
without any conversion of date or time fields. If self is aware and without any conversion of date or time fields. If self is aware and
\code{tz.utcoffset(self)} does not return \code{None}, the date and \code{tz.utcoffset(self)} does not return \code{None}, the date and
time fields are adjusted so that the result is local time in timezone time fields are adjusted so that the result is local time in timezone
tz, representing the same UTC time as self. \code{self.astimezone(tz)} tz, representing the same UTC time as self.
is then equivalent to XXX [The treatment of endcases remains unclear: for DST-aware
\begin{verbatim} classes, one hour per year has two spellings in local time, and
(self - (self.utcoffset() - tz.utcoffset(self)).replace(tzinfo=tz) another hour has no spelling in local time.] XXX
\end{verbatim}
where the result of \code{tz.utcoffset(self)} is converted to a
\class{timedelta} if it's an integer.
\end{methoddesc} \end{methoddesc}
\begin{methoddesc}{utcoffset}{} \begin{methoddesc}{utcoffset}{}