mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-28 11:15:17 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

#14766: Reflow the altered paragraphs.

Browse source
This commit is contained in:
R David Murray 2012-05-14 22:33:36 -04:00
parent 089d4d4f7c
commit 8349bc2ba9
1 changed files with 17 additions and 17 deletions
Download patch file Download diff file Expand all files Collapse all files

34
Doc/library/datetime.rst
View file

@ -14,8 +14,8 @@
The :mod:`datetime` module supplies classes for manipulating dates and times in 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 both simple and complex ways. While date and time arithmetic is supported, the
focus of the implementation is on efficient attribute extraction for output focus of the implementation is on efficient attribute extraction for output
formatting and manipulation. For related formatting and manipulation. For related functionality, see also the
functionality, see also the :mod:`time` and :mod:`calendar` modules. :mod:`time` and :mod:`calendar` modules.
There are two kinds of date and time objects: "naive" and "aware". 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 [#]_. interpretation [#]_.
+A naive object does not contain enough information to unambiguously locate +A naive object does not contain enough information to unambiguously locate
+itself relative to other date/time objects. Whether +itself relative to other date/time objects. Whether a naive object represents
a naive object represents Coordinated Universal Time (UTC), Coordinated Universal Time (UTC), local time, or time in some other timezone is
local time, or time in some other timezone is purely up to the program, just purely up to the program, just like it's up to the program whether a particular
like it's up to the program whether a particular number represents metres, number represents metres, miles, or mass. Naive objects are easy to understand
miles, or mass. Naive objects are easy to understand and to and to work with, at the cost of ignoring some aspects of reality.
work with, at the cost of ignoring some aspects of reality.
For applications requiring aware objects, :class:`.datetime` and :class:`.time` objects For applications requiring aware objects, :class:`.datetime` and :class:`.time`
have an optional time zone information attribute, :attr:`tzinfo`, that can be objects have an optional time zone information attribute, :attr:`tzinfo`, that
set to an instance of a subclass of the abstract :class:`tzinfo` class. These can be set to an instance of a subclass of the abstract :class:`tzinfo` class.
:class:`tzinfo` objects capture information about the offset from UTC time, the These :class:`tzinfo` objects capture information about the offset from UTC
time zone name, and whether Daylight Saving Time is in effect. Note that no time, the time zone name, and whether Daylight Saving Time is in effect. Note
concrete :class:`tzinfo` classes are supplied by the :mod:`datetime` module. that no concrete :class:`tzinfo` classes are supplied by the :mod:`datetime`
Supporting timezones at whatever level of detail is required is up to the module. Supporting timezones at whatever level of detail is required is up to
application. The rules for time adjustment across the world are more political the application. The rules for time adjustment across the world are more
than rational, and there is no standard suitable for every application. political than rational, and there is no standard suitable for every
application.
The :mod:`datetime` module exports the following constants: The :mod:`datetime` module exports the following constants: