# Copyright (C) 2001 Python Software Foundation

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

#

# Translators:

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2026-03-11 00:16+0000\n"

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

"Last-Translator: Griiid <[email protected]>\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:15

msgid ""

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

"times."

msgstr ":mod:`!datetime` 模組提供操作日期與時間的類別。"

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

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:22

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

msgstr "跳轉至\\ :ref:`格式碼 (format codes) <format-codes>`。"

#: ../../library/datetime.rst:26

msgid "Module :mod:`calendar`"

msgstr ":mod:`calendar` 模組"

#: ../../library/datetime.rst:27

msgid "General calendar related functions."

msgstr "與日曆相關的一般函式。"

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

msgid "Module :mod:`time`"

msgstr ":mod:`time` 模組"

#: ../../library/datetime.rst:30

msgid "Time access and conversions."

msgstr ""

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

msgid "Module :mod:`zoneinfo`"

msgstr ":mod:`zoneinfo` 模組"

#: ../../library/datetime.rst:33

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

msgstr ""

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

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

msgstr "`dateutil <https://dateutil.readthedocs.io/en/stable/>`_ 套件"

#: ../../library/datetime.rst:36

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

msgstr "帶有時區與剖析擴充支援的第三方函式庫。"

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

msgid "Package :pypi:`DateType`"

msgstr ":pypi:`DateType` 套件"

#: ../../library/datetime.rst:39

msgid ""

"Third-party library that introduces distinct static types to for example, "

"allow :term:`static type checkers <static type checker>` to differentiate "

"between naive and aware datetimes."

msgstr ""

#: ../../library/datetime.rst:47

msgid "Aware and naive objects"

msgstr ""

#: ../../library/datetime.rst:49

msgid ""

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

"on whether or not they include time zone information."

msgstr ""

#: ../../library/datetime.rst:52

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:58

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 time zone 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:65

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:71

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 time zones with fixed offsets from UTC, such as UTC itself "

"or North American EST and EDT time zones. Supporting time zones 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:81

msgid "Constants"

msgstr "常數"

#: ../../library/datetime.rst:83

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

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

#: ../../library/datetime.rst:87

msgid ""

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

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

msgstr ""

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

msgid ""

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

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

msgstr ""

#: ../../library/datetime.rst:99

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

msgstr ""

#: ../../library/datetime.rst:105

msgid "Available types"

msgstr ""

#: ../../library/datetime.rst:110

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:118

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:127

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:135

msgid ""

"A duration expressing the difference between two :class:`.datetime` or :"

"class:`date` instances to microsecond resolution."

msgstr ""

"表示兩個 :class:`.datetime` 或 :class:`date` 實例之間時間的差異，以微秒為解析"

"度。"

#: ../../library/datetime.rst:142

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:151

msgid ""

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

"offset from the UTC."

msgstr ""

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

msgid "Objects of these types are immutable."

msgstr ""

#: ../../library/datetime.rst:159

msgid "Subclass relationships:"

msgstr ""

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

msgid ""

"timedelta, tzinfo, time, and date inherit from object; timezone inherits\n"

"from tzinfo; and datetime inherits from date."

msgstr ""

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

msgid "Common properties"

msgstr "常見屬性"

#: ../../library/datetime.rst:171

msgid ""

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

"types share these common features:"

msgstr ""

#: ../../library/datetime.rst:175

msgid ""

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

"as dictionary keys."

msgstr ""

#: ../../library/datetime.rst:177

msgid ""

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

"module."

msgstr ""

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

msgid "Determining if an object is aware or naive"

msgstr ""

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

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

msgstr ""

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

msgid ""

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

msgstr ""

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

msgid ""

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

msgstr ""

#: ../../library/datetime.rst:189

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

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

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

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

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

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

msgid "Otherwise, ``d`` is naive."

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

#: ../../library/datetime.rst:194

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

msgstr ""

#: ../../library/datetime.rst:196

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

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

#: ../../library/datetime.rst:197

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

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

#: ../../library/datetime.rst:199

msgid "Otherwise, ``t`` is naive."

msgstr "否則 ``t`` 會是 naive 的。"

#: ../../library/datetime.rst:201

msgid ""

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

"objects."

msgstr ""

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

msgid ":class:`!timedelta` objects"

msgstr ":class:`!timedelta` 物件"

#: ../../library/datetime.rst:210

msgid ""

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

"two :class:`.datetime` or :class:`date` instances."

msgstr ""

"一個 :class:`timedelta` 物件代表著一段持續時間，即兩個 :class:`.datetime` "

"或 :class:`date` 之間的差異。"

#: ../../library/datetime.rst:215

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:218

msgid ""

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

"are converted to those units:"

msgstr ""

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

msgid "A millisecond is converted to 1000 microseconds."

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

#: ../../library/datetime.rst:222

msgid "A minute is converted to 60 seconds."

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

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

msgid "An hour is converted to 3600 seconds."

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

#: ../../library/datetime.rst:224

msgid "A week is converted to 7 days."

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

#: ../../library/datetime.rst:226

msgid ""

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

"representation is unique, with"

msgstr ""

#: ../../library/datetime.rst:229

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

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

#: ../../library/datetime.rst:230

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

msgstr ""

#: ../../library/datetime.rst:231

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

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

#: ../../library/datetime.rst:233

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:237

msgid ""

">>> import datetime as dt\n"

">>> delta = dt.timedelta(\n"

"... days=50,\n"

"... seconds=27,\n"

"... microseconds=10,\n"

"... milliseconds=29000,\n"

"... minutes=5,\n"

"... hours=8,\n"

"... weeks=2\n"

"... )\n"

">>> # Only days, seconds, and microseconds remain\n"

">>> delta\n"

"datetime.timedelta(days=64, seconds=29156, microseconds=10)"

msgstr ""

#: ../../library/datetime.rst:252

msgid ""

"``import datetime as dt`` instead of ``import datetime`` or ``from datetime "

"import datetime`` to avoid confusion between the module and the class. See "

"`How I Import Python’s datetime Module <https://adamj.eu/tech/2019/09/12/how-"

"i-import-pythons-datetime-module/>`__."

msgstr ""

#: ../../library/datetime.rst:257

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:264

msgid ""

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

"`OverflowError` is raised."

msgstr ""

#: ../../library/datetime.rst:267

msgid ""

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

"example::"

msgstr ""

#: ../../library/datetime.rst:270

msgid ""

">>> import datetime as dt\n"

">>> d = dt.timedelta(microseconds=-1)\n"

">>> (d.days, d.seconds, d.microseconds)\n"

"(-1, 86399, 999999)"

msgstr ""

">>> import datetime as dt\n"

">>> d = dt.timedelta(microseconds=-1)\n"

">>> (d.days, d.seconds, d.microseconds)\n"

"(-1, 86399, 999999)"

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

msgid ""

"Since the string representation of :class:`!timedelta` objects can be "

"confusing, use the following recipe to produce a more readable format:"

msgstr ""

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

msgid ""

">>> def pretty_timedelta(td):\n"

"... if td.days >= 0:\n"

"... return str(td)\n"

"... return f'-({-td!s})'\n"

"...\n"

">>> d = timedelta(hours=-1)\n"

">>> str(d) # not human-friendly\n"

"'-1 day, 23:00:00'\n"

">>> pretty_timedelta(d)\n"

"'-(1:00:00)'"

msgstr ""

">>> def pretty_timedelta(td):\n"

"... if td.days >= 0:\n"

"... return str(td)\n"

"... return f'-({-td!s})'\n"

"...\n"

">>> d = timedelta(hours=-1)\n"

">>> str(d) # not human-friendly\n"

"'-1 day, 23:00:00'\n"

">>> pretty_timedelta(d)\n"

"'-(1:00:00)'"

#: ../../library/datetime.rst:292 ../../library/datetime.rst:630

#: ../../library/datetime.rst:1200 ../../library/datetime.rst:1845

#: ../../library/datetime.rst:2481

msgid "Class attributes:"

msgstr "類別屬性："

#: ../../library/datetime.rst:296

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

msgstr ""

#: ../../library/datetime.rst:301

msgid ""

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

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

msgstr ""

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

msgid ""

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

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

msgstr ""

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

msgid ""

"Note that, because of normalization, ``timedelta.max`` is greater than ``-"

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

"`timedelta` object."

msgstr ""

#: ../../library/datetime.rst:315 ../../library/datetime.rst:648

#: ../../library/datetime.rst:1220 ../../library/datetime.rst:1865

msgid "Instance attributes (read-only):"

msgstr ""

#: ../../library/datetime.rst:319

msgid "Between -999,999,999 and 999,999,999 inclusive."

msgstr "在 -999,999,999 到 999,999,999 （含）之間"

#: ../../library/datetime.rst:324

msgid "Between 0 and 86,399 inclusive."

msgstr "在 0 到 86,399 （含）之間"

#: ../../library/datetime.rst:328

msgid ""

"It is a somewhat common bug for code to unintentionally use this attribute "

"when it is actually intended to get a :meth:`~timedelta.total_seconds` value "

"instead:"

msgstr ""

#: ../../library/datetime.rst:332

msgid ""

">>> import datetime as dt\n"

">>> duration = dt.timedelta(seconds=11235813)\n"

">>> duration.days, duration.seconds\n"

"(130, 3813)\n"

">>> duration.total_seconds()\n"

"11235813.0"

msgstr ""

">>> import datetime as dt\n"

">>> duration = dt.timedelta(seconds=11235813)\n"

">>> duration.days, duration.seconds\n"

"(130, 3813)\n"

">>> duration.total_seconds()\n"

"11235813.0"

#: ../../library/datetime.rst:344

msgid "Between 0 and 999,999 inclusive."

msgstr "在 0 到 999,999 （含）之間"

#: ../../library/datetime.rst:347 ../../library/datetime.rst:665

#: ../../library/datetime.rst:1274

msgid "Supported operations:"

msgstr ""

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

#: ../../library/datetime.rst:1277

msgid "Operation"

msgstr ""

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

#: ../../library/datetime.rst:1277

msgid "Result"

msgstr ""

#: ../../library/datetime.rst:352

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

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

#: ../../library/datetime.rst:352

msgid ""

"Sum of ``t2`` and ``t3``. Afterwards ``t1 - t2 == t3`` and ``t1 - t3 == t2`` "

"are true. (1)"

msgstr ""

#: ../../library/datetime.rst:356

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

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

#: ../../library/datetime.rst:356

msgid ""

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

"t1 + t3`` are true. (1)(6)"

msgstr ""

#: ../../library/datetime.rst:360

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

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

#: ../../library/datetime.rst:360

msgid ""

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

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

msgstr ""

#: ../../library/datetime.rst:364

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

msgstr ""

#: ../../library/datetime.rst:367

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

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

#: ../../library/datetime.rst:367

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:371

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

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

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

msgid ""

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

"class:`float` object."

msgstr ""

#: ../../library/datetime.rst:375

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

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

#: ../../library/datetime.rst:375

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:379

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

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

#: ../../library/datetime.rst:379

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:383

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

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

#: ../../library/datetime.rst:383

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

msgstr ""

#: ../../library/datetime.rst:386

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

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

#: ../../library/datetime.rst:386

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:391

msgid "``+t1``"

msgstr "``+t1``"

#: ../../library/datetime.rst:391

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

msgstr ""

#: ../../library/datetime.rst:394

msgid "``-t1``"

msgstr "``-t1``"

#: ../../library/datetime.rst:394

msgid ""

"Equivalent to ``timedelta(-t1.days, -t1.seconds, -t1.microseconds)``, and to "

"``t1 * -1``. (1)(4)"

msgstr ""

"等價於 ``timedelta(-t1.days, -t1.seconds, -t1.microseconds)``，也等價於 ``t1 "

"* -1``。 (1)(4)"

#: ../../library/datetime.rst:398

msgid "``abs(t)``"

msgstr "``abs(t)``"

#: ../../library/datetime.rst:398

msgid ""

"Equivalent to ``+t`` when ``t.days >= 0``, and to ``-t`` when ``t.days < "

"0``. (2)"

msgstr ""

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

msgid "``str(t)``"

msgstr "``str(t)``"

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

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:405

msgid "``repr(t)``"

msgstr "``repr(t)``"

#: ../../library/datetime.rst:405

msgid ""

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

"constructor call with canonical attribute values."

msgstr ""

#: ../../library/datetime.rst:410 ../../library/datetime.rst:687

#: ../../library/datetime.rst:2750

msgid "Notes:"

msgstr "註解："

#: ../../library/datetime.rst:413

msgid "This is exact but may overflow."

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

#: ../../library/datetime.rst:416

msgid "This is exact and cannot overflow."

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

#: ../../library/datetime.rst:419

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

msgstr ""

#: ../../library/datetime.rst:422

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

msgstr ""

#: ../../library/datetime.rst:425

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:429

msgid ""

">>> timedelta(hours=-5)\n"

"datetime.timedelta(days=-1, seconds=68400)\n"

">>> print(_)\n"

"-1 day, 19:00:00"

msgstr ""

">>> timedelta(hours=-5)\n"

"datetime.timedelta(days=-1, seconds=68400)\n"

">>> print(_)\n"

"-1 day, 19:00:00"

#: ../../library/datetime.rst:435

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:439

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:443

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:449

msgid ":class:`timedelta` objects support equality and order comparisons."

msgstr ""

#: ../../library/datetime.rst:451

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:454 ../../library/datetime.rst:729

#: ../../library/datetime.rst:1365 ../../library/datetime.rst:1990

msgid "Instance methods:"

msgstr "實例方法："

#: ../../library/datetime.rst:458

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 (for example, ``td / timedelta(microseconds=1)``)."

msgstr ""

#: ../../library/datetime.rst:462

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:469

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

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

#: ../../library/datetime.rst:471

msgid "An additional example of normalization::"

msgstr ""

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

msgid ""

">>> # Components of another_year add up to exactly 365 days\n"

">>> import datetime as dt\n"

">>> year = dt.timedelta(days=365)\n"

">>> another_year = dt.timedelta(weeks=40, days=84, hours=23,\n"

"... minutes=50, seconds=600)\n"

">>> year == another_year\n"

"True\n"

">>> year.total_seconds()\n"

"31536000.0"

msgstr ""

#: ../../library/datetime.rst:483

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

msgstr ""

#: ../../library/datetime.rst:485

msgid ""

">>> import datetime as dt\n"

">>> year = dt.timedelta(days=365)\n"

">>> ten_years = 10 * year\n"

">>> ten_years\n"

"datetime.timedelta(days=3650)\n"

">>> ten_years.days // 365\n"

"10\n"

">>> nine_years = ten_years - year\n"

">>> nine_years\n"

"datetime.timedelta(days=3285)\n"

">>> three_years = nine_years // 3\n"

">>> three_years, three_years.days // 365\n"

"(datetime.timedelta(days=1095), 3)"

msgstr ""

">>> import datetime as dt\n"

">>> year = dt.timedelta(days=365)\n"

">>> ten_years = 10 * year\n"

">>> ten_years\n"

"datetime.timedelta(days=3650)\n"

">>> ten_years.days // 365\n"

"10\n"

">>> nine_years = ten_years - year\n"

">>> nine_years\n"

"datetime.timedelta(days=3285)\n"

">>> three_years = nine_years // 3\n"

">>> three_years, three_years.days // 365\n"

"(datetime.timedelta(days=1095), 3)"

#: ../../library/datetime.rst:503

msgid ":class:`!date` objects"

msgstr ":class:`!date` 物件"

#: ../../library/datetime.rst:505

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:509

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:514

msgid ""

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

"ranges:"

msgstr ""

#: ../../library/datetime.rst:517

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

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

#: ../../library/datetime.rst:518

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

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

#: ../../library/datetime.rst:519

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

msgstr "``1 <= day <= 該年該月的天數``"

#: ../../library/datetime.rst:521 ../../library/datetime.rst:950

msgid ""

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

msgstr ""

#: ../../library/datetime.rst:524 ../../library/datetime.rst:956

msgid "Other constructors, all class methods:"

msgstr ""

#: ../../library/datetime.rst:528

msgid "Return the current local date."

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

#: ../../library/datetime.rst:530

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

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

#: ../../library/datetime.rst:535

msgid ""

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

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

msgstr ""

#: ../../library/datetime.rst:538

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:545

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:554

msgid ""

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

"January 1 of year 1 has ordinal 1."

msgstr ""

#: ../../library/datetime.rst:557

msgid ""

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

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

msgstr ""

#: ../../library/datetime.rst:564

msgid ""

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

"ISO 8601 format, with the following exceptions:"

msgstr ""

#: ../../library/datetime.rst:567 ../../library/datetime.rst:1121

msgid ""

"Reduced precision dates are not currently supported (``YYYY-MM``, ``YYYY``)."

msgstr ""

#: ../../library/datetime.rst:569 ../../library/datetime.rst:1123

msgid ""

"Extended date representations are not currently supported (``±YYYYYY-MM-"

"DD``)."

msgstr ""

#: ../../library/datetime.rst:571 ../../library/datetime.rst:1125

msgid "Ordinal dates are not currently supported (``YYYY-OOO``)."

msgstr ""

#: ../../library/datetime.rst:573 ../../library/datetime.rst:1127

#: ../../library/datetime.rst:1599

msgid "Examples::"

msgstr "範例： ::"

#: ../../library/datetime.rst:575

msgid ""

">>> import datetime as dt\n"

">>> dt.date.fromisoformat('2019-12-04')\n"

"datetime.date(2019, 12, 4)\n"

">>> dt.date.fromisoformat('20191204')\n"

"datetime.date(2019, 12, 4)\n"

">>> dt.date.fromisoformat('2021-W01-1')\n"

"datetime.date(2021, 1, 4)"

msgstr ""

">>> import datetime as dt\n"

">>> dt.date.fromisoformat('2019-12-04')\n"

"datetime.date(2019, 12, 4)\n"

">>> dt.date.fromisoformat('20191204')\n"

"datetime.date(2019, 12, 4)\n"

">>> dt.date.fromisoformat('2021-W01-1')\n"

"datetime.date(2021, 1, 4)"

#: ../../library/datetime.rst:584

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

msgstr ""

#: ../../library/datetime.rst:590

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:598

msgid ""

"Return a :class:`.date` corresponding to *date_string*, parsed according to "

"*format*. This is equivalent to::"

msgstr ""

#: ../../library/datetime.rst:601

msgid "date(*(time.strptime(date_string, format)[0:3]))"

msgstr "date(*(time.strptime(date_string, format)[0:3]))"

#: ../../library/datetime.rst:603

msgid ""

":exc:`ValueError` is raised if the date_string and format can't be parsed "

"by :func:`time.strptime` or if it returns a value which isn't a time tuple. "

"See also :ref:`strftime-strptime-behavior` and :meth:`date.fromisoformat`."

msgstr ""

#: ../../library/datetime.rst:610

msgid ""

"If *format* specifies a day of month without a year a :exc:"

"`DeprecationWarning` is emitted. This is to avoid a quadrennial leap year "

"bug in code seeking to parse only a month and day as the default year used "

"in absence of one in the format is not a leap year. Such *format* values may "

"raise an error as of Python 3.15. The workaround is to always include a "

"year in your *format*. If parsing *date_string* values that do not have a "

"year, explicitly add a year that is a leap year before parsing:"

msgstr ""

#: ../../library/datetime.rst:619

msgid ""

">>> import datetime as dt\n"

">>> date_string = \"02/29\"\n"

">>> when = dt.date.strptime(f\"{date_string};1984\", \"%m/%d;%Y\") # Avoids "

"leap year bug.\n"

">>> when.strftime(\"%B %d\")\n"