summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStuart Bishop <stuart@stuartbishop.net>2016-04-22 19:57:53 +0700
committerStuart Bishop <stuart@stuartbishop.net>2016-04-22 19:57:53 +0700
commit53a9db37a96524ee500230cee5865d81dad93a51 (patch)
tree37276350ade090e839c45fb9cec050362c0232e2
parentd807e8cd0fe82a03d74ef90e889fd1f3c1eabb30 (diff)
downloadpytz-trunk.tar.gz
Fix old example insisting normalize() is necessary after astimezone() conversionHEADrelease_2016.4trunk
-rw-r--r--src/README.txt10
1 files changed, 6 insertions, 4 deletions
diff --git a/src/README.txt b/src/README.txt
index 00566ae..064b760 100644
--- a/src/README.txt
+++ b/src/README.txt
@@ -134,19 +134,21 @@ section for more details)
>>> dt2.strftime(fmt)
'2002-10-27 01:30:00 EST-0500'
-Converting between timezones also needs special attention. We also need
-to use the ``normalize()`` method to ensure the conversion is correct.
+Converting between timezones is more easily done, using the
+standard astimezone method.
>>> utc_dt = utc.localize(datetime.utcfromtimestamp(1143408899))
>>> utc_dt.strftime(fmt)
'2006-03-26 21:34:59 UTC+0000'
>>> au_tz = timezone('Australia/Sydney')
->>> au_dt = au_tz.normalize(utc_dt.astimezone(au_tz))
+>>> au_dt = utc_dt.astimezone(au_tz)
>>> au_dt.strftime(fmt)
'2006-03-27 08:34:59 AEDT+1100'
->>> utc_dt2 = utc.normalize(au_dt.astimezone(utc))
+>>> utc_dt2 = au_dt.astimezone(utc)
>>> utc_dt2.strftime(fmt)
'2006-03-26 21:34:59 UTC+0000'
+>>> utc_dt == utc_dt2
+True
You can take shortcuts when dealing with the UTC side of timezone
conversions. ``normalize()`` and ``localize()`` are not really