From 026225ff566a858d6ef625c2bb2cb092ad20daa5 Mon Sep 17 00:00:00 2001 From: Brandon Rhodes Date: Thu, 17 Dec 2015 00:15:24 -0500 Subject: [PATCH] Tweak a paragraph in the documentation --- ephem/doc/date.rst | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/ephem/doc/date.rst b/ephem/doc/date.rst index 465b17a4..9c07a00a 100644 --- a/ephem/doc/date.rst +++ b/ephem/doc/date.rst @@ -129,10 +129,12 @@ Datetime objects is why PyEphem exposes its own date type instead of returning Python ``datetime`` objects automatically. - Note that python ``datetime`` objects use local time by default. - PyEphem expects UTC ``datetime`` objects. ``datetime.now()`` will - give unexpected results. Use ``datetime.utcnow()`` instead: - + Note that Python ``datetime`` objects use your local time by default, + whereas PyEphem expects time to be expressed in UTC. + This means that passing ``datetime.now()`` to PyEphem + will give unexpected results. + Instead, use the ``datetime.utcnow()`` constructor: + >>> d = datetime.datetime.utcnow() >>> ephem.Date(d) 2015/12/14 15:42:14