# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2022, Python Software Foundation

# This file is distributed under the same license as the Python package.

#

# Translators:

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2023-08-23 00:03+0000\n"

"PO-Revision-Date: 2023-08-07 10:20+0800\n"

"Last-Translator: Griiid <gridwing@gmail.com>\n"

"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=1; plural=0;\n"

"X-Generator: Poedit 3.3.2\n"

#: ../../library/datetime.rst:2

msgid ":mod:`datetime` --- Basic date and time types"

msgstr ":mod:`datetime` --- 日期與時間的基本型別"

#: ../../library/datetime.rst:11

msgid "**Source code:** :source:`Lib/datetime.py`"

msgstr "**原始碼：**\\ :source:`Lib/datetime.py`"

#: ../../library/datetime.rst:17

msgid ""

"The :mod:`datetime` module supplies classes for manipulating dates and times."

msgstr ""

#: ../../library/datetime.rst:19

msgid ""

"While date and time arithmetic is supported, the focus of the implementation "

"is on efficient attribute extraction for output formatting and manipulation."

msgstr ""

#: ../../library/datetime.rst:24

msgid "Skip to :ref:`the format codes <format-codes>`."

msgstr ""

#: ../../library/datetime.rst:29

msgid "Module :mod:`calendar`"

msgstr ":mod:`calendar` 模組"

#: ../../library/datetime.rst:29

msgid "General calendar related functions."

msgstr ""

#: ../../library/datetime.rst:32

msgid "Module :mod:`time`"

msgstr ":mod:`time` 模組"

#: ../../library/datetime.rst:32

msgid "Time access and conversions."

msgstr ""

#: ../../library/datetime.rst:35

msgid "Module :mod:`zoneinfo`"

msgstr ":mod:`zoneinfo` 模組"

#: ../../library/datetime.rst:35

msgid "Concrete time zones representing the IANA time zone database."

msgstr ""

#: ../../library/datetime.rst:37

msgid "Package `dateutil <https://dateutil.readthedocs.io/en/stable/>`_"

msgstr ""

#: ../../library/datetime.rst:38

msgid "Third-party library with expanded time zone and parsing support."

msgstr ""

#: ../../library/datetime.rst:43

msgid "Aware and Naive Objects"

msgstr ""

#: ../../library/datetime.rst:45

msgid ""

"Date and time objects may be categorized as \"aware\" or \"naive\" depending "

"on whether or not they include timezone information."

msgstr ""

#: ../../library/datetime.rst:48

msgid ""

"With sufficient knowledge of applicable algorithmic and political time "

"adjustments, such as time zone and daylight saving time information, an "

"**aware** object can locate itself relative to other aware objects. An aware "

"object represents a specific moment in time that is not open to "

"interpretation. [#]_"

msgstr ""

#: ../../library/datetime.rst:54

msgid ""

"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 is 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."

msgstr ""

#: ../../library/datetime.rst:61

msgid ""

"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."

msgstr ""

#: ../../library/datetime.rst:67

msgid ""

"Only one concrete :class:`tzinfo` class, the :class:`timezone` class, is "

"supplied by the :mod:`datetime` module. The :class:`timezone` class can "

"represent simple timezones with fixed offsets from UTC, such as UTC itself "

"or North American EST and EDT timezones. Supporting timezones at deeper "

"levels of detail is up to the application. The rules for time adjustment "

"across the world are more political than rational, change frequently, and "

"there is no standard suitable for every application aside from UTC."

msgstr ""

#: ../../library/datetime.rst:76

msgid "Constants"

msgstr "常數"

#: ../../library/datetime.rst:78

msgid "The :mod:`datetime` module exports the following constants:"

msgstr ":mod:`datetime` 模組匯出以下常數："

#: ../../library/datetime.rst:82

msgid ""

"The smallest year number allowed in a :class:`date` or :class:`.datetime` "

"object. :const:`MINYEAR` is ``1``."

msgstr ""

#: ../../library/datetime.rst:88

msgid ""

"The largest year number allowed in a :class:`date` or :class:`.datetime` "

"object. :const:`MAXYEAR` is ``9999``."

msgstr ""

#: ../../library/datetime.rst:93

msgid "Alias for the UTC timezone singleton :attr:`datetime.timezone.utc`."

msgstr ""

#: ../../library/datetime.rst:98

msgid "Available Types"

msgstr ""

#: ../../library/datetime.rst:103

msgid ""

"An idealized naive date, assuming the current Gregorian calendar always was, "

"and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, and :"

"attr:`day`."

msgstr ""

#: ../../library/datetime.rst:111

msgid ""

"An idealized time, independent of any particular day, assuming that every "

"day has exactly 24\\*60\\*60 seconds. (There is no notion of \"leap "

"seconds\" here.) Attributes: :attr:`hour`, :attr:`minute`, :attr:`second`, :"

"attr:`microsecond`, and :attr:`.tzinfo`."

msgstr ""

#: ../../library/datetime.rst:120

msgid ""

"A combination of a date and a time. Attributes: :attr:`year`, :attr:"

"`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:"

"`microsecond`, and :attr:`.tzinfo`."

msgstr ""

#: ../../library/datetime.rst:128

msgid ""

"A duration expressing the difference between two :class:`date`, :class:`."

"time`, or :class:`.datetime` instances to microsecond resolution."

msgstr ""

"表示兩個 :class:`date`、:class:`.time` 或 :class:`.datetime` 實例之間時間的差"

"異，以微秒為解析度。"

#: ../../library/datetime.rst:135

msgid ""

"An abstract base class for time zone information objects. These are used by "

"the :class:`.datetime` and :class:`.time` classes to provide a customizable "

"notion of time adjustment (for example, to account for time zone and/or "

"daylight saving time)."

msgstr ""

#: ../../library/datetime.rst:143

msgid ""

"A class that implements the :class:`tzinfo` abstract base class as a fixed "

"offset from the UTC."

msgstr ""

#: ../../library/datetime.rst:148 ../../library/datetime.rst:166

msgid "Objects of these types are immutable."

msgstr ""

#: ../../library/datetime.rst:150

msgid "Subclass relationships::"

msgstr ""

#: ../../library/datetime.rst:161

msgid "Common Properties"

msgstr "常見屬性"

#: ../../library/datetime.rst:163

msgid ""

"The :class:`date`, :class:`.datetime`, :class:`.time`, and :class:`timezone` "

"types share these common features:"

msgstr ""

#: ../../library/datetime.rst:167

msgid ""

"Objects of these types are :term:`hashable`, meaning that they can be used "

"as dictionary keys."

msgstr ""

#: ../../library/datetime.rst:169

msgid ""

"Objects of these types support efficient pickling via the :mod:`pickle` "

"module."

msgstr ""

#: ../../library/datetime.rst:172

msgid "Determining if an Object is Aware or Naive"

msgstr ""

#: ../../library/datetime.rst:174

msgid "Objects of the :class:`date` type are always naive."

msgstr ""

#: ../../library/datetime.rst:176

msgid ""

"An object of type :class:`.time` or :class:`.datetime` may be aware or naive."

msgstr ""

#: ../../library/datetime.rst:178

msgid "A :class:`.datetime` object *d* is aware if both of the following hold:"

msgstr ""

#: ../../library/datetime.rst:180

msgid "``d.tzinfo`` is not ``None``"

msgstr "``d.tzinfo`` 不是 ``None``"

#: ../../library/datetime.rst:181

msgid "``d.tzinfo.utcoffset(d)`` does not return ``None``"

msgstr "``d.tzinfo.utcoffset(d)`` 不會回傳 ``None``"

#: ../../library/datetime.rst:183

msgid "Otherwise, *d* is naive."

msgstr "否則 *d* 會是 naive 的。"

#: ../../library/datetime.rst:185

msgid "A :class:`.time` object *t* is aware if both of the following hold:"

msgstr ""

#: ../../library/datetime.rst:187

msgid "``t.tzinfo`` is not ``None``"

msgstr "``t.tzinfo`` 不是 ``None``"

#: ../../library/datetime.rst:188

msgid "``t.tzinfo.utcoffset(None)`` does not return ``None``."

msgstr "``t.tzinfo.utcoffset(None)`` 沒有回傳 ``None``\\ 。"

#: ../../library/datetime.rst:190

msgid "Otherwise, *t* is naive."

msgstr ""

#: ../../library/datetime.rst:192

msgid ""

"The distinction between aware and naive doesn't apply to :class:`timedelta` "

"objects."

msgstr ""

#: ../../library/datetime.rst:198

msgid ":class:`timedelta` Objects"

msgstr ":class:`timedelta` 物件"

#: ../../library/datetime.rst:200

msgid ""

"A :class:`timedelta` object represents a duration, the difference between "

"two dates or times."

msgstr ""

"一個 :class:`timedelta` 物件代表著一段持續時間，即兩個日期或時間之間的差異。"

#: ../../library/datetime.rst:205

msgid ""

"All arguments are optional and default to ``0``. Arguments may be integers "

"or floats, and may be positive or negative."

msgstr ""

#: ../../library/datetime.rst:208

msgid ""

"Only *days*, *seconds* and *microseconds* are stored internally. Arguments "

"are converted to those units:"

msgstr ""

#: ../../library/datetime.rst:211

msgid "A millisecond is converted to 1000 microseconds."

msgstr "一毫秒會被轉換為 1000 微秒。"

#: ../../library/datetime.rst:212

msgid "A minute is converted to 60 seconds."

msgstr "一分鐘會被轉換為 60 秒。"

#: ../../library/datetime.rst:213

msgid "An hour is converted to 3600 seconds."

msgstr "一小時會被轉換為 3600 秒。"

#: ../../library/datetime.rst:214

msgid "A week is converted to 7 days."

msgstr "一週會被轉換為 7 天。"

#: ../../library/datetime.rst:216

msgid ""

"and days, seconds and microseconds are then normalized so that the "

"representation is unique, with"

msgstr ""

#: ../../library/datetime.rst:219

msgid "``0 <= microseconds < 1000000``"

msgstr "``0 <= microseconds < 1000000``"

#: ../../library/datetime.rst:220

msgid "``0 <= seconds < 3600*24`` (the number of seconds in one day)"

msgstr ""

#: ../../library/datetime.rst:221

msgid "``-999999999 <= days <= 999999999``"

msgstr "``-999999999 <= days <= 999999999``"

#: ../../library/datetime.rst:223

msgid ""

"The following example illustrates how any arguments besides *days*, "

"*seconds* and *microseconds* are \"merged\" and normalized into those three "

"resulting attributes::"

msgstr ""

#: ../../library/datetime.rst:241

msgid ""

"If any argument is a float and there are fractional microseconds, the "

"fractional microseconds left over from all arguments are combined and their "

"sum is rounded to the nearest microsecond using round-half-to-even "

"tiebreaker. If no argument is a float, the conversion and normalization "

"processes are exact (no information is lost)."

msgstr ""

#: ../../library/datetime.rst:248

msgid ""

"If the normalized value of days lies outside the indicated range, :exc:"

"`OverflowError` is raised."

msgstr ""

#: ../../library/datetime.rst:251

msgid ""

"Note that normalization of negative values may be surprising at first. For "

"example::"

msgstr ""

#: ../../library/datetime.rst:260 ../../library/datetime.rst:556

#: ../../library/datetime.rst:1069 ../../library/datetime.rst:1688

#: ../../library/datetime.rst:2290

msgid "Class attributes:"

msgstr "類別屬性："

#: ../../library/datetime.rst:264

msgid "The most negative :class:`timedelta` object, ``timedelta(-999999999)``."

msgstr ""

#: ../../library/datetime.rst:269

msgid ""

"The most positive :class:`timedelta` object, ``timedelta(days=999999999, "

"hours=23, minutes=59, seconds=59, microseconds=999999)``."

msgstr ""

#: ../../library/datetime.rst:275

msgid ""

"The smallest possible difference between non-equal :class:`timedelta` "

"objects, ``timedelta(microseconds=1)``."

msgstr ""

#: ../../library/datetime.rst:278

msgid ""

"Note that, because of normalization, ``timedelta.max`` > ``-timedelta.min``. "

"``-timedelta.max`` is not representable as a :class:`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:281 ../../library/datetime.rst:574

#: ../../library/datetime.rst:1089 ../../library/datetime.rst:1708

msgid "Instance attributes (read-only):"

msgstr ""

#: ../../library/datetime.rst:284

msgid "Attribute"

msgstr "屬性"

#: ../../library/datetime.rst:284

msgid "Value"

msgstr ""

#: ../../library/datetime.rst:286

msgid "``days``"

msgstr "``days``"

#: ../../library/datetime.rst:286

msgid "Between -999999999 and 999999999 inclusive"

msgstr ""

#: ../../library/datetime.rst:288

msgid "``seconds``"

msgstr "``seconds``"

#: ../../library/datetime.rst:288

msgid "Between 0 and 86399 inclusive"

msgstr "在 0 到 86399 （含）之間"

#: ../../library/datetime.rst:290

msgid "``microseconds``"

msgstr "``microseconds``"

#: ../../library/datetime.rst:290

msgid "Between 0 and 999999 inclusive"

msgstr "在 0 到 999999 （含）之間"

#: ../../library/datetime.rst:293 ../../library/datetime.rst:591

#: ../../library/datetime.rst:1142

msgid "Supported operations:"

msgstr ""

#: ../../library/datetime.rst:298 ../../library/datetime.rst:594

#: ../../library/datetime.rst:1145

msgid "Operation"

msgstr ""

#: ../../library/datetime.rst:298 ../../library/datetime.rst:594

#: ../../library/datetime.rst:1145

msgid "Result"

msgstr ""

#: ../../library/datetime.rst:300

msgid "``t1 = t2 + t3``"

msgstr "``t1 = t2 + t3``"

#: ../../library/datetime.rst:300

msgid ""

"Sum of *t2* and *t3*. Afterwards *t1*-*t2* == *t3* and *t1*-*t3* == *t2* are "

"true. (1)"

msgstr ""

#: ../../library/datetime.rst:303

msgid "``t1 = t2 - t3``"

msgstr "``t1 = t2 - t3``"

#: ../../library/datetime.rst:303

msgid ""

"Difference of *t2* and *t3*. Afterwards *t1* == *t2* - *t3* and *t2* == *t1* "

"+ *t3* are true. (1)(6)"

msgstr ""

#: ../../library/datetime.rst:307

msgid "``t1 = t2 * i or t1 = i * t2``"

msgstr "``t1 = t2 * i or t1 = i * t2``"

#: ../../library/datetime.rst:307

msgid ""

"Delta multiplied by an integer. Afterwards *t1* // i == *t2* is true, "

"provided ``i != 0``."

msgstr ""

#: ../../library/datetime.rst:311

msgid "In general, *t1* \\* i == *t1* \\* (i-1) + *t1* is true. (1)"

msgstr ""

#: ../../library/datetime.rst:314

msgid "``t1 = t2 * f or t1 = f * t2``"

msgstr "``t1 = t2 * f or t1 = f * t2``"

#: ../../library/datetime.rst:314

msgid ""

"Delta multiplied by a float. The result is rounded to the nearest multiple "

"of timedelta.resolution using round-half-to-even."

msgstr ""

#: ../../library/datetime.rst:318

msgid "``f = t2 / t3``"

msgstr "``f = t2 / t3``"

#: ../../library/datetime.rst:318

msgid ""

"Division (3) of overall duration *t2* by interval unit *t3*. Returns a :"

"class:`float` object."

msgstr ""

#: ../../library/datetime.rst:322

msgid "``t1 = t2 / f or t1 = t2 / i``"

msgstr "``t1 = t2 / f or t1 = t2 / i``"

#: ../../library/datetime.rst:322

msgid ""

"Delta divided by a float or an int. The result is rounded to the nearest "

"multiple of timedelta.resolution using round-half-to-even."

msgstr ""

#: ../../library/datetime.rst:326

msgid "``t1 = t2 // i`` or ``t1 = t2 // t3``"

msgstr "``t1 = t2 // i`` or ``t1 = t2 // t3``"

#: ../../library/datetime.rst:326

msgid ""

"The floor is computed and the remainder (if any) is thrown away. In the "

"second case, an integer is returned. (3)"

msgstr ""

#: ../../library/datetime.rst:330

msgid "``t1 = t2 % t3``"

msgstr "``t1 = t2 % t3``"

#: ../../library/datetime.rst:330

msgid "The remainder is computed as a :class:`timedelta` object. (3)"

msgstr ""

#: ../../library/datetime.rst:333

msgid "``q, r = divmod(t1, t2)``"

msgstr "``q, r = divmod(t1, t2)``"

#: ../../library/datetime.rst:333

msgid ""

"Computes the quotient and the remainder: ``q = t1 // t2`` (3) and ``r = t1 % "

"t2``. q is an integer and r is a :class:`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:338

msgid "``+t1``"

msgstr "``+t1``"

#: ../../library/datetime.rst:338

msgid "Returns a :class:`timedelta` object with the same value. (2)"

msgstr ""

#: ../../library/datetime.rst:341

msgid "``-t1``"

msgstr "``-t1``"

#: ../../library/datetime.rst:341

msgid ""

"equivalent to :class:`timedelta`\\ (-*t1.days*, -*t1.seconds*, -*t1."

"microseconds*), and to *t1*\\* -1. (1)(4)"

msgstr ""

#: ../../library/datetime.rst:346

msgid "``abs(t)``"

msgstr "``abs(t)``"

#: ../../library/datetime.rst:346

msgid ""

"equivalent to +\\ *t* when ``t.days >= 0``, and to -*t* when ``t.days < 0``. "

"(2)"

msgstr ""

#: ../../library/datetime.rst:349

msgid "``str(t)``"

msgstr "``str(t)``"

#: ../../library/datetime.rst:349

msgid ""

"Returns a string in the form ``[D day[s], ][H]H:MM:SS[.UUUUUU]``, where D is "

"negative for negative ``t``. (5)"

msgstr ""

#: ../../library/datetime.rst:353

msgid "``repr(t)``"

msgstr "``repr(t)``"

#: ../../library/datetime.rst:353

msgid ""

"Returns a string representation of the :class:`timedelta` object as a "

"constructor call with canonical attribute values."

msgstr ""

#: ../../library/datetime.rst:359 ../../library/datetime.rst:608

#: ../../library/datetime.rst:2521

msgid "Notes:"

msgstr "註解："

#: ../../library/datetime.rst:362

msgid "This is exact but may overflow."

msgstr "這是精確的，但可能會溢位。"

#: ../../library/datetime.rst:365

msgid "This is exact and cannot overflow."

msgstr "這是精確的，且不會溢位。"

#: ../../library/datetime.rst:368

msgid "Division by 0 raises :exc:`ZeroDivisionError`."

msgstr ""

#: ../../library/datetime.rst:371

msgid "-*timedelta.max* is not representable as a :class:`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:374

msgid ""

"String representations of :class:`timedelta` objects are normalized "

"similarly to their internal representation. This leads to somewhat unusual "

"results for negative timedeltas. For example::"

msgstr ""

#: ../../library/datetime.rst:384

msgid ""

"The expression ``t2 - t3`` will always be equal to the expression ``t2 + (-"

"t3)`` except when t3 is equal to ``timedelta.max``; in that case the former "

"will produce a result while the latter will overflow."

msgstr ""

#: ../../library/datetime.rst:388

msgid ""

"In addition to the operations listed above, :class:`timedelta` objects "

"support certain additions and subtractions with :class:`date` and :class:`."

"datetime` objects (see below)."

msgstr ""

#: ../../library/datetime.rst:392

msgid ""

"Floor division and true division of a :class:`timedelta` object by another :"

"class:`timedelta` object are now supported, as are remainder operations and "

"the :func:`divmod` function. True division and multiplication of a :class:"

"`timedelta` object by a :class:`float` object are now supported."

msgstr ""

#: ../../library/datetime.rst:399

msgid ""

"Comparisons of :class:`timedelta` objects are supported, with some caveats."

msgstr ""

#: ../../library/datetime.rst:401

msgid ""

"The comparisons ``==`` or ``!=`` *always* return a :class:`bool`, no matter "

"the type of the compared object::"

msgstr ""

#: ../../library/datetime.rst:412

msgid ""

"For all other comparisons (such as ``<`` and ``>``), when a :class:"

"`timedelta` object is compared to an object of a different type, :exc:"

"`TypeError` is raised::"

msgstr ""

#: ../../library/datetime.rst:423

msgid ""

"In Boolean contexts, a :class:`timedelta` object is considered to be true if "

"and only if it isn't equal to ``timedelta(0)``."

msgstr ""

#: ../../library/datetime.rst:426 ../../library/datetime.rst:637

#: ../../library/datetime.rst:1216 ../../library/datetime.rst:1816

msgid "Instance methods:"

msgstr "實例方法："

#: ../../library/datetime.rst:430

msgid ""

"Return the total number of seconds contained in the duration. Equivalent to "

"``td / timedelta(seconds=1)``. For interval units other than seconds, use "

"the division form directly (e.g. ``td / timedelta(microseconds=1)``)."

msgstr ""

#: ../../library/datetime.rst:434

msgid ""

"Note that for very large time intervals (greater than 270 years on most "

"platforms) this method will lose microsecond accuracy."

msgstr ""

#: ../../library/datetime.rst:440

msgid "Examples of usage: :class:`timedelta`"

msgstr "用法範例：\\ :class:`timedelta`"

#: ../../library/datetime.rst:442

msgid "An additional example of normalization::"

msgstr ""

#: ../../library/datetime.rst:454

msgid "Examples of :class:`timedelta` arithmetic::"

msgstr ""

#: ../../library/datetime.rst:473

msgid ":class:`date` Objects"

msgstr ":class:`date` 物件"

#: ../../library/datetime.rst:475

msgid ""

"A :class:`date` object represents a date (year, month and day) in an "

"idealized calendar, the current Gregorian calendar indefinitely extended in "

"both directions."

msgstr ""

#: ../../library/datetime.rst:479

msgid ""

"January 1 of year 1 is called day number 1, January 2 of year 1 is called "

"day number 2, and so on. [#]_"

msgstr ""

#: ../../library/datetime.rst:484

msgid ""

"All arguments are required. Arguments must be integers, in the following "

"ranges:"

msgstr ""

#: ../../library/datetime.rst:487

msgid "``MINYEAR <= year <= MAXYEAR``"

msgstr "``MINYEAR <= year <= MAXYEAR``"

#: ../../library/datetime.rst:488

msgid "``1 <= month <= 12``"

msgstr "``1 <= month <= 12``"

#: ../../library/datetime.rst:489

msgid "``1 <= day <= number of days in the given month and year``"

msgstr ""

#: ../../library/datetime.rst:491 ../../library/datetime.rst:852

msgid ""

"If an argument outside those ranges is given, :exc:`ValueError` is raised."

msgstr ""

#: ../../library/datetime.rst:494 ../../library/datetime.rst:857

msgid "Other constructors, all class methods:"

msgstr ""

#: ../../library/datetime.rst:498

msgid "Return the current local date."

msgstr "回傳目前的本地日期。"

#: ../../library/datetime.rst:500

msgid "This is equivalent to ``date.fromtimestamp(time.time())``."

msgstr "這等同於 ``date.fromtimestamp(time.time())``。"

#: ../../library/datetime.rst:504

msgid ""

"Return the local date corresponding to the POSIX timestamp, such as is "

"returned by :func:`time.time`."

msgstr ""

#: ../../library/datetime.rst:507

msgid ""

"This may raise :exc:`OverflowError`, if the timestamp is out of the range of "

"values supported by the platform C :c:func:`localtime` function, and :exc:"

"`OSError` on :c:func:`localtime` failure. It's common for this to be "

"restricted to years from 1970 through 2038. Note that on non-POSIX systems "

"that include leap seconds in their notion of a timestamp, leap seconds are "

"ignored by :meth:`fromtimestamp`."

msgstr ""

#: ../../library/datetime.rst:514

msgid ""

"Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is "

"out of the range of values supported by the platform C :c:func:`localtime` "

"function. Raise :exc:`OSError` instead of :exc:`ValueError` on :c:func:"

"`localtime` failure."

msgstr ""

#: ../../library/datetime.rst:523

msgid ""

"Return the date corresponding to the proleptic Gregorian ordinal, where "

"January 1 of year 1 has ordinal 1."

msgstr ""

#: ../../library/datetime.rst:526

msgid ""

":exc:`ValueError` is raised unless ``1 <= ordinal <= date.max.toordinal()``. "

"For any date *d*, ``date.fromordinal(d.toordinal()) == d``."

msgstr ""

#: ../../library/datetime.rst:533

msgid ""

"Return a :class:`date` corresponding to a *date_string* given in any valid "

"ISO 8601 format, except ordinal dates (e.g. ``YYYY-DDD``)::"

msgstr ""

#: ../../library/datetime.rst:545

msgid "Previously, this method only supported the format ``YYYY-MM-DD``."

msgstr ""

#: ../../library/datetime.rst:550

msgid ""

"Return a :class:`date` corresponding to the ISO calendar date specified by "

"year, week and day. This is the inverse of the function :meth:`date."

"isocalendar`."

msgstr ""

#: ../../library/datetime.rst:560

msgid "The earliest representable date, ``date(MINYEAR, 1, 1)``."

msgstr ""

#: ../../library/datetime.rst:565

msgid "The latest representable date, ``date(MAXYEAR, 12, 31)``."

msgstr ""

#: ../../library/datetime.rst:570

msgid ""

"The smallest possible difference between non-equal date objects, "

"``timedelta(days=1)``."

msgstr ""

#: ../../library/datetime.rst:578 ../../library/datetime.rst:1093

msgid "Between :const:`MINYEAR` and :const:`MAXYEAR` inclusive."

msgstr ""

#: ../../library/datetime.rst:583 ../../library/datetime.rst:1098

msgid "Between 1 and 12 inclusive."

msgstr "在 1 到 12 （含）之間。"

#: ../../library/datetime.rst:588 ../../library/datetime.rst:1103

msgid "Between 1 and the number of days in the given month of the given year."

msgstr ""

#: ../../library/datetime.rst:596

msgid "``date2 = date1 + timedelta``"

msgstr "``date2 = date1 + timedelta``"

#: ../../library/datetime.rst:596

msgid "*date2* will be ``timedelta.days`` days after *date1*. (1)"

msgstr ""

#: ../../library/datetime.rst:599

msgid "``date2 = date1 - timedelta``"

msgstr "``date2 = date1 - timedelta``"

#: ../../library/datetime.rst:599

msgid "Computes *date2* such that ``date2 + timedelta == date1``. (2)"

msgstr ""

#: ../../library/datetime.rst:602

msgid "``timedelta = date1 - date2``"

msgstr "``timedelta = date1 - date2``"

#: ../../library/datetime.rst:602 ../../library/datetime.rst:1151

msgid "\\(3)"

msgstr "\\(3)"

#: ../../library/datetime.rst:604

msgid "``date1 < date2``"

msgstr "``date1 < date2``"

#: ../../library/datetime.rst:604

msgid ""

"*date1* is considered less than *date2* when *date1* precedes *date2* in "

"time. (4)"

msgstr ""

#: ../../library/datetime.rst:611

msgid ""

"*date2* is moved forward in time if ``timedelta.days > 0``, or backward if "

"``timedelta.days < 0``. Afterward ``date2 - date1 == timedelta.days``. "

"``timedelta.seconds`` and ``timedelta.microseconds`` are ignored. :exc:"

"`OverflowError` is raised if ``date2.year`` would be smaller than :const:"

"`MINYEAR` or larger than :const:`MAXYEAR`."

msgstr ""

#: ../../library/datetime.rst:618

msgid "``timedelta.seconds`` and ``timedelta.microseconds`` are ignored."

msgstr "``timedelta.seconds`` 和 ``timedelta.microseconds`` 被忽略。"

#: ../../library/datetime.rst:621

msgid ""

"This is exact, and cannot overflow. timedelta.seconds and timedelta."

"microseconds are 0, and date2 + timedelta == date1 after."

msgstr ""

#: ../../library/datetime.rst:625

msgid ""

"In other words, ``date1 < date2`` if and only if ``date1.toordinal() < date2."

"toordinal()``. Date comparison raises :exc:`TypeError` if the other "

"comparand isn't also a :class:`date` object. However, ``NotImplemented`` is "

"returned instead if the other comparand has a :meth:`timetuple` attribute. "

"This hook gives other kinds of date objects a chance at implementing mixed-"

"type comparison. If not, when a :class:`date` object is compared to an "

"object of a different type, :exc:`TypeError` is raised unless the comparison "

"is ``==`` or ``!=``. The latter cases return :const:`False` or :const:"

"`True`, respectively."

msgstr ""

#: ../../library/datetime.rst:635

msgid ""

"In Boolean contexts, all :class:`date` objects are considered to be true."

msgstr ""

#: ../../library/datetime.rst:641

msgid ""

"Return a date with the same value, except for those parameters given new "

"values by whichever keyword arguments are specified."

msgstr ""

#: ../../library/datetime.rst:644 ../../library/datetime.rst:1859

msgid "Example::"

msgstr ""

"範例：\n"

"\n"

"::"

#: ../../library/datetime.rst:654 ../../library/datetime.rst:1329

msgid ""

"Return a :class:`time.struct_time` such as returned by :func:`time."

"localtime`."

msgstr ""

"回傳一個 :class:`time.struct_time`，如同 :func:`time.localtime` 所回傳。"

#: ../../library/datetime.rst:656

msgid "The hours, minutes and seconds are 0, and the DST flag is -1."

msgstr ""

#: ../../library/datetime.rst:658 ../../library/datetime.rst:1331

msgid "``d.timetuple()`` is equivalent to::"

msgstr ""

"``d.timetuple()`` 等價於：\n"

"\n"

"::"

#: ../../library/datetime.rst:662

msgid ""

"where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the "

"day number within the current year starting with ``1`` for January 1st."

msgstr ""

#: ../../library/datetime.rst:668

msgid ""

"Return the proleptic Gregorian ordinal of the date, where January 1 of year "

"1 has ordinal 1. For any :class:`date` object *d*, ``date.fromordinal(d."

"toordinal()) == d``."

msgstr ""

#: ../../library/datetime.rst:675

msgid ""

"Return the day of the week as an integer, where Monday is 0 and Sunday is 6. "

"For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See also :"

"meth:`isoweekday`."

msgstr ""

"回傳一個代表星期幾的整數，星期一為 0、星期日為 6。例如 ``date(2002, 12, 4)."

"weekday() == 2`` 為星期三。也請參考 :meth:`isoweekday`。"

#: ../../library/datetime.rst:682

msgid ""

"Return the day of the week as an integer, where Monday is 1 and Sunday is 7. "

"For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See also :"

"meth:`weekday`, :meth:`isocalendar`."

msgstr ""

#: ../../library/datetime.rst:689

msgid ""

"Return a :term:`named tuple` object with three components: ``year``, "

"``week`` and ``weekday``."

msgstr ""

#: ../../library/datetime.rst:692

msgid ""

"The ISO calendar is a widely used variant of the Gregorian calendar. [#]_"

msgstr ""

#: ../../library/datetime.rst:694

msgid ""

"The ISO year consists of 52 or 53 full weeks, and where a week starts on a "

"Monday and ends on a Sunday. The first week of an ISO year is the first "

"(Gregorian) calendar week of a year containing a Thursday. This is called "

"week number 1, and the ISO year of that Thursday is the same as its "

"Gregorian year."

msgstr ""

#: ../../library/datetime.rst:699

msgid ""

"For example, 2004 begins on a Thursday, so the first week of ISO year 2004 "

"begins on Monday, 29 Dec 2003 and ends on Sunday, 4 Jan 2004::"

msgstr ""

#: ../../library/datetime.rst:708

msgid "Result changed from a tuple to a :term:`named tuple`."

msgstr ""

#: ../../library/datetime.rst:713

msgid ""

"Return a string representing the date in ISO 8601 format, ``YYYY-MM-DD``::"

msgstr ""

"回傳一以 ISO 8601 格式 ``YYYY-MM-DD`` 表示的日期字串：\n"

"\n"

"::"

#: ../../library/datetime.rst:721

msgid "For a date *d*, ``str(d)`` is equivalent to ``d.isoformat()``."

msgstr ""

#: ../../library/datetime.rst:726

msgid "Return a string representing the date::"

msgstr ""

#: ../../library/datetime.rst:732 ../../library/datetime.rst:1515

msgid "``d.ctime()`` is equivalent to::"

msgstr ""