mirror of https://github.com/python/cpython
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:
parent
3f0b542f25
commit
9532298c82
|
@ -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}{}
|
||||||
|
|
Loading…
Reference in New Issue