summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2012-05-15 02:33:36 (GMT)
committerR David Murray <rdmurray@bitdance.com>2012-05-15 02:33:36 (GMT)
commit8349bc2ba93bbe9c130adc6a9a3d6e24c2f6140f (patch)
treebcba12fcde19437e23b707e02a111e8a47fa4c89
parent089d4d4f7c7d3aff9fc509f565183138f0b2d926 (diff)
downloadcpython-8349bc2ba93bbe9c130adc6a9a3d6e24c2f6140f.zip
cpython-8349bc2ba93bbe9c130adc6a9a3d6e24c2f6140f.tar.gz
cpython-8349bc2ba93bbe9c130adc6a9a3d6e24c2f6140f.tar.bz2
#14766: Reflow the altered paragraphs.
-rw-r--r--Doc/library/datetime.rst36
1 files changed, 18 insertions, 18 deletions
diff --git a/Doc/library/datetime.rst b/Doc/library/datetime.rst
index 7baf987..4fc7e9e 100644
--- a/Doc/library/datetime.rst
+++ b/Doc/library/datetime.rst
@@ -14,8 +14,8 @@
The :mod:`datetime` module supplies classes for manipulating dates and times in
both simple and complex ways. While date and time arithmetic is supported, the
focus of the implementation is on efficient attribute extraction for output
-formatting and manipulation. For related
-functionality, see also the :mod:`time` and :mod:`calendar` modules.
+formatting and manipulation. For related functionality, see also the
+:mod:`time` and :mod:`calendar` modules.
There are two kinds of date and time objects: "naive" and "aware".
@@ -26,22 +26,22 @@ is used to represent a specific moment in time that is not open to
interpretation [#]_.
+A naive object does not contain enough information to unambiguously locate
-+itself relative to other date/time objects. Whether
-a naive object represents Coordinated Universal Time (UTC),
-local time, or time in some other timezone is purely up to the program, just
-like it's up to the program whether a particular number represents metres,
-miles, or mass. Naive objects are easy to understand and to
-work with, at the cost of ignoring some aspects of reality.
-
-For applications requiring aware objects, :class:`.datetime` and :class:`.time` objects
-have an optional time zone information attribute, :attr:`tzinfo`, that can be
-set to an instance of a subclass of the abstract :class:`tzinfo` class. These
-:class:`tzinfo` objects capture information about the offset from UTC time, the
-time zone name, and whether Daylight Saving Time is in effect. Note that no
-concrete :class:`tzinfo` classes are supplied by the :mod:`datetime` module.
-Supporting timezones at whatever level of detail is required is up to the
-application. The rules for time adjustment across the world are more political
-than rational, and there is no standard suitable for every application.
++itself relative to other date/time objects. Whether a naive object represents
+Coordinated Universal Time (UTC), local time, or time in some other timezone is
+purely up to the program, just like it's up to the program whether a particular
+number represents metres, miles, or mass. Naive objects are easy to understand
+and to work with, at the cost of ignoring some aspects of reality.
+
+For applications requiring aware objects, :class:`.datetime` and :class:`.time`
+objects have an optional time zone information attribute, :attr:`tzinfo`, that
+can be set to an instance of a subclass of the abstract :class:`tzinfo` class.
+These :class:`tzinfo` objects capture information about the offset from UTC
+time, the time zone name, and whether Daylight Saving Time is in effect. Note
+that no concrete :class:`tzinfo` classes are supplied by the :mod:`datetime`
+module. Supporting timezones at whatever level of detail is required is up to
+the application. The rules for time adjustment across the world are more
+political than rational, and there is no standard suitable for every
+application.
The :mod:`datetime` module exports the following constants: