@@ -48,7 +48,7 @@ Aware and Naive Objects
4848-----------------------
4949
5050Date and time objects may be categorized as "aware" or "naive" depending on
51- whether or not they include timezone information.
51+ whether or not they include time zone information.
5252
5353With sufficient knowledge of applicable algorithmic and political time
5454adjustments, such as time zone and daylight saving time information,
@@ -58,7 +58,7 @@ interpretation. [#]_
5858
5959A **naive ** object does not contain enough information to unambiguously locate
6060itself relative to other date/time objects. Whether a naive object represents
61- Coordinated Universal Time (UTC), local time, or time in some other timezone is
61+ Coordinated Universal Time (UTC), local time, or time in some other time zone is
6262purely up to the program, just like it is up to the program whether a
6363particular number represents metres, miles, or mass. Naive objects are easy to
6464understand and to work with, at the cost of ignoring some aspects of reality.
@@ -70,9 +70,9 @@ These :class:`tzinfo` objects capture information about the offset from UTC
7070time, the time zone name, and whether daylight saving time is in effect.
7171
7272Only one concrete :class: `tzinfo ` class, the :class: `timezone ` class, is
73- supplied by the :mod: `!datetime ` module. The :class: `timezone ` class can
74- represent simple timezones with fixed offsets from UTC, such as UTC itself or
75- North American EST and EDT timezones . Supporting timezones at deeper levels of
73+ supplied by the :mod: `!datetime ` module. The :class: `! timezone ` class can
74+ represent simple time zones with fixed offsets from UTC, such as UTC itself or
75+ North American EST and EDT time zones . Supporting time zones at deeper levels of
7676detail is up to the application. The rules for time adjustment across the
7777world are more political than rational, change frequently, and there is no
7878standard suitable for every application aside from UTC.
@@ -95,7 +95,7 @@ The :mod:`!datetime` module exports the following constants:
9595
9696.. attribute :: UTC
9797
98- Alias for the UTC timezone singleton :attr: `datetime.timezone.utc `.
98+ Alias for the UTC time zone singleton :attr: `datetime.timezone.utc `.
9999
100100 .. versionadded :: 3.11
101101
@@ -850,7 +850,7 @@ Other constructors, all class methods:
850850
851851.. classmethod :: datetime.today()
852852
853- Return the current local datetime , with :attr: `.tzinfo ` ``None ``.
853+ Return the current local date and time , with :attr: `.tzinfo ` ``None ``.
854854
855855 Equivalent to::
856856
@@ -1051,7 +1051,7 @@ Other constructors, all class methods:
10511051 Return a :class: `.datetime ` corresponding to *date_string *, parsed according to
10521052 *format *.
10531053
1054- If *format * does not contain microseconds or timezone information, this is equivalent to::
1054+ If *format * does not contain microseconds or time zone information, this is equivalent to::
10551055
10561056 datetime(*(time.strptime(date_string, format)[0:6]))
10571057
@@ -1267,22 +1267,22 @@ Instance methods:
12671267
12681268 If provided, *tz * must be an instance of a :class: `tzinfo ` subclass, and its
12691269 :meth: `utcoffset ` and :meth: `dst ` methods must not return ``None ``. If *self *
1270- is naive, it is presumed to represent time in the system timezone .
1270+ is naive, it is presumed to represent time in the system time zone .
12711271
12721272 If called without arguments (or with ``tz=None ``) the system local
1273- timezone is assumed for the target timezone . The ``.tzinfo `` attribute of the converted
1273+ time zone is assumed for the target time zone . The ``.tzinfo `` attribute of the converted
12741274 datetime instance will be set to an instance of :class: `timezone `
12751275 with the zone name and offset obtained from the OS.
12761276
12771277 If ``self.tzinfo `` is *tz *, ``self.astimezone(tz) `` is equal to *self *: no
12781278 adjustment of date or time data is performed. Else the result is local
1279- time in the timezone *tz *, representing the same UTC time as *self *: after
1279+ time in the time zone *tz *, representing the same UTC time as *self *: after
12801280 ``astz = dt.astimezone(tz) ``, ``astz - astz.utcoffset() `` will have
12811281 the same date and time data as ``dt - dt.utcoffset() ``.
12821282
1283- If you merely want to attach a time zone object *tz * to a datetime *dt * without
1283+ If you merely want to attach a :class: ` timezone ` object *tz * to a datetime *dt * without
12841284 adjustment of date and time data, use ``dt.replace(tzinfo=tz) ``. If you
1285- merely want to remove the time zone object from an aware datetime *dt * without
1285+ merely want to remove the :class: ` !timezone ` object from an aware datetime *dt * without
12861286 conversion of date and time data, use ``dt.replace(tzinfo=None) ``.
12871287
12881288 Note that the default :meth: `tzinfo.fromutc ` method can be overridden in a
@@ -1292,7 +1292,7 @@ Instance methods:
12921292 def astimezone(self, tz):
12931293 if self.tzinfo is tz:
12941294 return self
1295- # Convert self to UTC, and attach the new time zone object.
1295+ # Convert self to UTC, and attach the new timezone object.
12961296 utc = (self - self.utcoffset()).replace(tzinfo=tz)
12971297 # Convert from UTC to tz's local time.
12981298 return tz.fromutc(utc)
@@ -1406,7 +1406,7 @@ Instance methods:
14061406
14071407 There is no method to obtain the POSIX timestamp directly from a
14081408 naive :class: `.datetime ` instance representing UTC time. If your
1409- application uses this convention and your system timezone is not
1409+ application uses this convention and your system time zone is not
14101410 set to UTC, you can obtain the POSIX timestamp by supplying
14111411 ``tzinfo=timezone.utc ``::
14121412
@@ -1974,7 +1974,7 @@ Examples of working with a :class:`.time` object::
19741974 supply implementations of the standard :class: `tzinfo ` methods needed by the
19751975 :class: `.datetime ` methods you use. The :mod: `!datetime ` module provides
19761976 :class: `timezone `, a simple concrete subclass of :class: `tzinfo ` which can
1977- represent timezones with fixed offset from UTC such as UTC itself or North
1977+ represent time zones with fixed offset from UTC such as UTC itself or North
19781978 American EST and EDT.
19791979
19801980 Special requirement for pickling: A :class: `tzinfo ` subclass must have an
@@ -2099,7 +2099,7 @@ When a :class:`.datetime` object is passed in response to a :class:`.datetime`
20992099method, ``dt.tzinfo `` is the same object as *self *. :class: `tzinfo ` methods can
21002100rely on this, unless user code calls :class: `tzinfo ` methods directly. The
21012101intent is that the :class: `tzinfo ` methods interpret *dt * as being in local
2102- time, and not need worry about objects in other timezones .
2102+ time, and not need worry about objects in other time zones .
21032103
21042104There is one more :class: `tzinfo ` method that a subclass may wish to override:
21052105
@@ -2216,12 +2216,12 @@ only EST (fixed offset -5 hours), or only EDT (fixed offset -4 hours)).
22162216 :mod: `zoneinfo `
22172217 The :mod: `!datetime ` module has a basic :class: `timezone ` class (for
22182218 handling arbitrary fixed offsets from UTC) and its :attr: `timezone.utc `
2219- attribute (a UTC timezone instance).
2219+ attribute (a UTC :class: ` ! timezone` instance).
22202220
2221- ``zoneinfo `` brings the *IANA timezone database * (also known as the Olson
2221+ ``zoneinfo `` brings the *IANA time zone database * (also known as the Olson
22222222 database) to Python, and its usage is recommended.
22232223
2224- `IANA timezone database <https://www.iana.org/time-zones >`_
2224+ `IANA time zone database <https://www.iana.org/time-zones >`_
22252225 The Time Zone Database (often called tz, tzdata or zoneinfo) contains code
22262226 and data that represent the history of local time for many representative
22272227 locations around the globe. It is updated periodically to reflect changes
@@ -2235,10 +2235,10 @@ only EST (fixed offset -5 hours), or only EDT (fixed offset -4 hours)).
22352235-------------------------
22362236
22372237The :class: `timezone ` class is a subclass of :class: `tzinfo `, each
2238- instance of which represents a timezone defined by a fixed offset from
2238+ instance of which represents a time zone defined by a fixed offset from
22392239UTC.
22402240
2241- Objects of this class cannot be used to represent timezone information in the
2241+ Objects of this class cannot be used to represent time zone information in the
22422242locations where different offsets are used in different days of the year or
22432243where historical changes have been made to civil time.
22442244
@@ -2299,7 +2299,7 @@ Class attributes:
22992299
23002300.. attribute :: timezone.utc
23012301
2302- The UTC timezone , ``timezone(timedelta(0)) ``.
2302+ The UTC time zone , ``timezone(timedelta(0)) ``.
23032303
23042304
23052305.. index ::
@@ -2508,7 +2508,7 @@ Using ``datetime.strptime(date_string, format)`` is equivalent to::
25082508
25092509 datetime(*(time.strptime(date_string, format)[0:6]))
25102510
2511- except when the format includes sub-second components or timezone offset
2511+ except when the format includes sub-second components or time zone offset
25122512information, which are supported in ``datetime.strptime `` but are discarded by
25132513``time.strptime ``.
25142514
0 commit comments