sync with cpython 4646ddc3

Author: github-actions[bot]

library/datetime.po

@@ -6,7 +6,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2025-12-01 00:17+0000\n"
+"POT-Creation-Date: 2025-12-22 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-"
@@ -680,7 +680,7 @@ msgid ""
 msgstr ""
 
 #: ../../library/datetime.rst:400 ../../library/datetime.rst:672
-#: ../../library/datetime.rst:2663
+#: ../../library/datetime.rst:2696
 msgid "Notes:"
 msgstr "註解："
 
@@ -1790,7 +1790,7 @@ msgid ""
 "equivalent to::"
 msgstr ""
 
-#: ../../library/datetime.rst:1148 ../../library/datetime.rst:2643
+#: ../../library/datetime.rst:1148 ../../library/datetime.rst:2676
 msgid "datetime(*(time.strptime(date_string, format)[0:6]))"
 msgstr "datetime(*(time.strptime(date_string, format)[0:6]))"
 
@@ -2126,7 +2126,7 @@ msgstr ""
 
 #: ../../library/datetime.rst:1431 ../../library/datetime.rst:2042
 #: ../../library/datetime.rst:2149 ../../library/datetime.rst:2394
-#: ../../library/datetime.rst:2406 ../../library/datetime.rst:2716
+#: ../../library/datetime.rst:2406 ../../library/datetime.rst:2749
 msgid "The UTC offset is not restricted to a whole number of minutes."
 msgstr ""
 
@@ -3947,7 +3947,7 @@ msgstr "000000, 000001, ..., 999999"
 msgid "\\(5)"
 msgstr "\\(5)"
 
-#: ../../library/datetime.rst:2545 ../../library/datetime.rst:2704
+#: ../../library/datetime.rst:2545 ../../library/datetime.rst:2737
 msgid "``%z``"
 msgstr "``%z``"
 
@@ -3966,7 +3966,7 @@ msgstr ""
 msgid "\\(6)"
 msgstr "\\(6)"
 
-#: ../../library/datetime.rst:2550 ../../library/datetime.rst:2730
+#: ../../library/datetime.rst:2550 ../../library/datetime.rst:2763
 msgid "``%Z``"
 msgstr "``%Z``"
 
@@ -4134,7 +4134,7 @@ msgstr "01, 02, ..., 53"
 msgid "\\(8), \\(9)"
 msgstr "\\(8), \\(9)"
 
-#: ../../library/datetime.rst:2607 ../../library/datetime.rst:2726
+#: ../../library/datetime.rst:2607 ../../library/datetime.rst:2759
 msgid "``%:z``"
 msgstr "``%:z``"
 
@@ -4188,23 +4188,43 @@ msgstr ""
 
 #: ../../library/datetime.rst:2637
 msgid ""
-"For the :meth:`.datetime.strptime` class method, the default value is "
-"``1900-01-01T00:00:00.000``: any components not specified in the format "
-"string will be pulled from the default value. [#]_"
+"For the :meth:`.datetime.strptime` and :meth:`.date.strptime` class methods, "
+"the default value is ``1900-01-01T00:00:00.000``: any components not "
+"specified in the format string will be pulled from the default value."
+msgstr ""
+
+#: ../../library/datetime.rst:2642
+msgid ""
+"When used to parse partial dates lacking a year, :meth:`.datetime.strptime` "
+"and :meth:`.date.strptime` will raise when encountering February 29 because "
+"the default year of 1900 is *not* a leap year.  Always add a default leap "
+"year to partial date strings before parsing."
 msgstr ""
 
-#: ../../library/datetime.rst:2641
+#: ../../library/datetime.rst:2663
+msgid ""
+">>> from datetime import datetime\n"
+">>> value = \"2/29\"\n"
+">>> datetime.strptime(value, \"%m/%d\")\n"
+"Traceback (most recent call last):\n"
+"...\n"
+"ValueError: day 29 must be in range 1..28 for month 2 in year 1900\n"
+">>> datetime.strptime(f\"1904 {value}\", \"%Y %m/%d\")\n"
+"datetime.datetime(1904, 2, 29, 0, 0)"
+msgstr ""
+
+#: ../../library/datetime.rst:2674
 msgid "Using ``datetime.strptime(date_string, format)`` is equivalent to::"
 msgstr ""
 
-#: ../../library/datetime.rst:2645
+#: ../../library/datetime.rst:2678
 msgid ""
 "except when the format includes sub-second components or time zone offset "
 "information, which are supported in ``datetime.strptime`` but are discarded "
 "by ``time.strptime``."
 msgstr ""
 
-#: ../../library/datetime.rst:2649
+#: ../../library/datetime.rst:2682
 msgid ""
 "For :class:`.time` objects, the format codes for year, month, and day should "
 "not be used, as :class:`!time` objects have no such values. If they're used "
@@ -4214,7 +4234,7 @@ msgstr ""
 "time` 物件並沒有這些值。如果使用這些格式碼，年份會以 1900 代替、月及日會以 1 "
 "代替。"
 
-#: ../../library/datetime.rst:2653
+#: ../../library/datetime.rst:2686
 msgid ""
 "For :class:`date` objects, the format codes for hours, minutes, seconds, and "
 "microseconds should not be used, as :class:`date` objects have no such "
@@ -4223,7 +4243,7 @@ msgstr ""
 "對 :class:`.date` 物件來說，不應該使用時、分、秒、微秒的格式碼，因為 :class:"
 "`date` 物件並沒有這些值。如果使用這些格式碼，這些值都會以 0 代替。"
 
-#: ../../library/datetime.rst:2657
+#: ../../library/datetime.rst:2690
 msgid ""
 "For the same reason, handling of format strings containing Unicode code "
 "points that can't be represented in the charset of the current locale is "
@@ -4232,64 +4252,64 @@ msgid ""
 "`UnicodeError` or return an empty string instead."
 msgstr ""
 
-#: ../../library/datetime.rst:2666
+#: ../../library/datetime.rst:2699
 msgid ""
 "Because the format depends on the current locale, care should be taken when "
 "making assumptions about the output value. Field orderings will vary (for "
 "example, \"month/day/year\" versus \"day/month/year\"), and the output may "
 "contain non-ASCII characters."
 msgstr ""
 
-#: ../../library/datetime.rst:2672
+#: ../../library/datetime.rst:2705
 msgid ""
 "The :meth:`~.datetime.strptime` method can parse years in the full [1, 9999] "
 "range, but years < 1000 must be zero-filled to 4-digit width."
 msgstr ""
 
-#: ../../library/datetime.rst:2675
+#: ../../library/datetime.rst:2708
 msgid ""
 "In previous versions, :meth:`~.datetime.strftime` method was restricted to "
 "years >= 1900."
 msgstr ""
 
-#: ../../library/datetime.rst:2679
+#: ../../library/datetime.rst:2712
 msgid ""
 "In version 3.2, :meth:`~.datetime.strftime` method was restricted to years "
 ">= 1000."
 msgstr ""
 
-#: ../../library/datetime.rst:2684
+#: ../../library/datetime.rst:2717
 msgid ""
 "When used with the :meth:`~.datetime.strptime` method, the ``%p`` directive "
 "only affects the output hour field if the ``%I`` directive is used to parse "
 "the hour."
 msgstr ""
 
-#: ../../library/datetime.rst:2688
+#: ../../library/datetime.rst:2721
 msgid ""
 "Unlike the :mod:`time` module, the :mod:`!datetime` module does not support "
 "leap seconds."
 msgstr ""
 
-#: ../../library/datetime.rst:2692
+#: ../../library/datetime.rst:2725
 msgid ""
 "When used with the :meth:`~.datetime.strptime` method, the ``%f`` directive "
 "accepts from one to six digits and zero pads on the right. ``%f`` is an "
 "extension to the set of format characters in the C standard (but implemented "
 "separately in datetime objects, and therefore always available)."
 msgstr ""
 
-#: ../../library/datetime.rst:2699
+#: ../../library/datetime.rst:2732
 msgid ""
 "For a naive object, the ``%z``, ``%:z`` and ``%Z`` format codes are replaced "
 "by empty strings."
 msgstr ""
 
-#: ../../library/datetime.rst:2702
+#: ../../library/datetime.rst:2735
 msgid "For an aware object:"
 msgstr ""
 
-#: ../../library/datetime.rst:2705
+#: ../../library/datetime.rst:2738
 msgid ""
 ":meth:`~.datetime.utcoffset` is transformed into a string of the form "
 "``±HHMM[SS[.ffffff]]``, where ``HH`` is a 2-digit string giving the number "
@@ -4303,7 +4323,7 @@ msgid ""
 "replaced with the string ``'-0330'``."
 msgstr ""
 
-#: ../../library/datetime.rst:2719
+#: ../../library/datetime.rst:2752
 msgid ""
 "When the ``%z`` directive is provided to the  :meth:`~.datetime.strptime` "
 "method, the UTC offsets can have a colon as a separator between hours, "
@@ -4312,78 +4332,78 @@ msgid ""
 "``'+00:00'``."
 msgstr ""
 
-#: ../../library/datetime.rst:2727
+#: ../../library/datetime.rst:2760
 msgid ""
 "Behaves exactly as ``%z``, but has a colon separator added between hours, "
 "minutes and seconds."
 msgstr ""
 
-#: ../../library/datetime.rst:2731
+#: ../../library/datetime.rst:2764
 msgid ""
 "In :meth:`~.datetime.strftime`, ``%Z`` is replaced by an empty string if :"
 "meth:`~.datetime.tzname` returns ``None``; otherwise ``%Z`` is replaced by "
 "the returned value, which must be a string."
 msgstr ""
 
-#: ../../library/datetime.rst:2735
+#: ../../library/datetime.rst:2768
 msgid ":meth:`~.datetime.strptime` only accepts certain values for ``%Z``:"
 msgstr ""
 
-#: ../../library/datetime.rst:2737
+#: ../../library/datetime.rst:2770
 msgid "any value in ``time.tzname`` for your machine's locale"
 msgstr ""
 
-#: ../../library/datetime.rst:2738
+#: ../../library/datetime.rst:2771
 msgid "the hard-coded values ``UTC`` and ``GMT``"
 msgstr ""
 
-#: ../../library/datetime.rst:2740
+#: ../../library/datetime.rst:2773
 msgid ""
 "So someone living in Japan may have ``JST``, ``UTC``, and ``GMT`` as valid "
 "values, but probably not ``EST``. It will raise ``ValueError`` for invalid "
 "values."
 msgstr ""
 
-#: ../../library/datetime.rst:2744
+#: ../../library/datetime.rst:2777
 msgid ""
 "When the ``%z`` directive is provided to the :meth:`~.datetime.strptime` "
 "method, an aware :class:`.datetime` object will be produced. The ``tzinfo`` "
 "of the result will be set to a :class:`timezone` instance."
 msgstr ""
 
-#: ../../library/datetime.rst:2750
+#: ../../library/datetime.rst:2783
 msgid ""
 "When used with the :meth:`~.datetime.strptime` method, ``%U`` and ``%W`` are "
 "only used in calculations when the day of the week and the calendar year "
 "(``%Y``) are specified."
 msgstr ""
 
-#: ../../library/datetime.rst:2755
+#: ../../library/datetime.rst:2788
 msgid ""
 "Similar to ``%U`` and ``%W``, ``%V`` is only used in calculations when the "
 "day of the week and the ISO year (``%G``) are specified in a :meth:`~."
 "datetime.strptime` format string. Also note that ``%G`` and ``%Y`` are not "
 "interchangeable."
 msgstr ""
 
-#: ../../library/datetime.rst:2761
+#: ../../library/datetime.rst:2794
 msgid ""
 "When used with the :meth:`~.datetime.strptime` method, the leading zero is "
 "optional for  formats ``%d``, ``%m``, ``%H``, ``%I``, ``%M``, ``%S``, "
 "``%j``, ``%U``, ``%W``, and ``%V``. Format ``%y`` does require a leading "
 "zero."
 msgstr ""
 
-#: ../../library/datetime.rst:2766
+#: ../../library/datetime.rst:2799
 msgid ""
 "When parsing a month and day using :meth:`~.datetime.strptime`, always "
 "include a year in the format.  If the value you need to parse lacks a year, "
 "append an explicit dummy leap year.  Otherwise your code will raise an "
 "exception when it encounters leap day because the default year used by the "
-"parser is not a leap year.  Users run into this bug every four years..."
+"parser (1900) is not a leap year.  Users run into that bug every leap year."
 msgstr ""
 
-#: ../../library/datetime.rst:2772
+#: ../../library/datetime.rst:2805
 msgid ""
 ">>> month_day = \"02/29\"\n"
 ">>> datetime.strptime(f\"{month_day};1984\", \"%m/%d;%Y\")  # No leap year "
@@ -4395,23 +4415,23 @@ msgstr ""
 "題。\n"
 "datetime.datetime(1984, 2, 29, 0, 0)"
 
-#: ../../library/datetime.rst:2778
+#: ../../library/datetime.rst:2811
 msgid ""
 ":meth:`~.datetime.strptime` calls using a format string containing a day of "
 "month without a year now emit a :exc:`DeprecationWarning`. In 3.15 or later "
 "we may change this into an error or change the default year to a leap year. "
 "See :gh:`70647`."
 msgstr ""
 
-#: ../../library/datetime.rst:2785
+#: ../../library/datetime.rst:2818
 msgid "Footnotes"
 msgstr "註解"
 
-#: ../../library/datetime.rst:2786
+#: ../../library/datetime.rst:2819
 msgid "If, that is, we ignore the effects of Relativity"
 msgstr "也就是說，我們會忽略相對論的效應"
 
-#: ../../library/datetime.rst:2788
+#: ../../library/datetime.rst:2821
 msgid ""
 "This matches the definition of the \"proleptic Gregorian\" calendar in "
 "Dershowitz and Reingold's book *Calendrical Calculations*, where it's the "
@@ -4420,19 +4440,13 @@ msgid ""
 "systems."
 msgstr ""
 
-#: ../../library/datetime.rst:2794
+#: ../../library/datetime.rst:2827
 msgid ""
 "See R. H. van Gent's `guide to the mathematics of the ISO 8601 calendar "
 "<https://web.archive.org/web/20220531051136/https://webspace.science.uu.nl/"
 "~gent0113/calendar/isocalendar.htm>`_ for a good explanation."
 msgstr ""
 
-#: ../../library/datetime.rst:2798
-msgid ""
-"Passing ``datetime.strptime('Feb 29', '%b %d')`` will fail since 1900 is not "
-"a leap year."
-msgstr ""
-
 #: ../../library/datetime.rst:2441
 msgid "% (percent)"
 msgstr "% （百分號）"