Complete Decimal objects section translation

Copilot · josix · Copilot · commit 79a8d1246b43 · 2025-07-12T11:17:09.000Z
Co-authored-by: josix &lt;18432820+josix@users.noreply.github.com&gt;
diff --git a/library/decimal.po b/library/decimal.po
@@ -548,11 +548,11 @@ msgstr ""
 
 #: ../../library/decimal.rst:343
 msgid "Decimal objects"
-msgstr ""
+msgstr "Decimal 物件"
 
 #: ../../library/decimal.rst:348
 msgid "Construct a new :class:`Decimal` object based from *value*."
-msgstr ""
+msgstr "基於 *value* 建構一個新的 :class:`Decimal` 物件。"
 
 #: ../../library/decimal.rst:350
 msgid ""
@@ -562,6 +562,9 @@ msgid ""
 "after leading and trailing whitespace characters, as well as underscores "
 "throughout, are removed::"
 msgstr ""
+"*value* 可以是整數、字串、元組、:class:`float` 或其他 :class:`Decimal` 物件。"
+"如果沒有提供 *value*，則回傳 ``Decimal('0')``。如果 *value* 是字串，在移除"
+"前後空白字元以及整個字串中的底線後，它應該符合十進位數字字串語法：:"
 
 #: ../../library/decimal.rst:355
 msgid ""
@@ -577,6 +580,17 @@ msgid ""
 "numeric-value  ::=  decimal-part [exponent-part] | infinity\n"
 "numeric-string ::=  [sign] numeric-value | [sign] nan"
 msgstr ""
+"sign           ::=  '+' | '-'\n"
+"digit          ::=  '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | "
+"'9'\n"
+"indicator      ::=  'e' | 'E'\n"
+"digits         ::=  digit [digit]...\n"
+"decimal-part   ::=  digits '.' [digits] | ['.'] digits\n"
+"exponent-part  ::=  indicator [sign] digits\n"
+"infinity       ::=  'Infinity' | 'Inf'\n"
+"nan            ::=  'NaN' [digits] | 'sNaN' [digits]\n"
+"numeric-value  ::=  decimal-part [exponent-part] | infinity\n"
+"numeric-string ::=  [sign] numeric-value | [sign] nan"
 
 #: ../../library/decimal.rst:366
 msgid ""
@@ -587,6 +601,10 @@ msgid ""
 "example, ``inf``, ``Inf``, ``INFINITY``, and ``iNfINity`` are all acceptable "
 "spellings for positive infinity."
 msgstr ""
+"在上面出現 ``digit`` 的地方也允許其他 Unicode 十進位數字。這些包括來自各種其他"
+"字母表的十進位數字（例如阿拉伯-印度數字和天城數字）以及全形數字 ``'\\uff10'`` "
+"到 ``'\\uff19'``。大小寫不重要，所以例如 ``inf``、``Inf``、``INFINITY`` 和 "
+"``iNfINity`` 都是正無窮大的可接受拼寫。"
 
 #: ../../library/decimal.rst:373
 msgid ""
@@ -595,6 +613,9 @@ msgid ""
 "an integer exponent. For example, ``Decimal((0, (1, 4, 1, 4), -3))`` returns "
 "``Decimal('1.414')``."
 msgstr ""
+"如果 *value* 是 :class:`tuple`，它應該有三個元件：一個符號（``0`` 代表正數或 "
+"``1`` 代表負數）、一個數字的 :class:`tuple`，以及一個整數指數。例如，"
+"``Decimal((0, (1, 4, 1, 4), -3))`` 回傳 ``Decimal('1.414')``。"
 
 #: ../../library/decimal.rst:378
 msgid ""
@@ -604,6 +625,9 @@ msgid ""
 "``Decimal(float('1.1'))`` converts to "
 "``Decimal('1.100000000000000088817841970012523233890533447265625')``."
 msgstr ""
+"如果 *value* 是 :class:`float`，二進位浮點數值會被無損轉換為其精確的十進位"
+"等價值。這種轉換通常需要 53 位或更多位數的精度。例如，``Decimal(float('1.1'))`` "
+"轉換為 ``Decimal('1.100000000000000088817841970012523233890533447265625')``。"
 
 #: ../../library/decimal.rst:384
 msgid ""
@@ -612,6 +636,8 @@ msgid ""
 "``Decimal('3.00000')`` records all five zeros even if the context precision "
 "is only three."
 msgstr ""
+"*context* 精度不會影響儲存多少位數。這完全由 *value* 中的位數決定。例如，即使"
+"上下文精度只有三位，``Decimal('3.00000')`` 也會記錄所有五個零。"
 
 #: ../../library/decimal.rst:389
 msgid ""
@@ -620,28 +646,35 @@ msgid ""
 "exception is raised; otherwise, the constructor returns a new Decimal with "
 "the value of ``NaN``."
 msgstr ""
+"*context* 引數的目的是決定當 *value* 是格式不正確的字串時該怎麼辦。如果上下文"
+"捕捉 :const:`InvalidOperation`，就會引發例外；否則，建構函式會回傳一個值為 "
+"``NaN`` 的新 Decimal。"
 
 #: ../../library/decimal.rst:394
 msgid "Once constructed, :class:`Decimal` objects are immutable."
-msgstr ""
+msgstr "一旦建構，:class:`Decimal` 物件就是不可變的。"
 
 #: ../../library/decimal.rst:396
 msgid ""
 "The argument to the constructor is now permitted to be a :class:`float` "
 "instance."
 msgstr ""
+"建構函式的引數現在允許是 :class:`float` 實例。"
 
 #: ../../library/decimal.rst:400
 msgid ""
 ":class:`float` arguments raise an exception if the :exc:`FloatOperation` "
 "trap is set. By default the trap is off."
 msgstr ""
+"如果設定了 :exc:`FloatOperation` 陷阱，:class:`float` 引數會引發例外。預設"
+"情況下陷阱是關閉的。"
 
 #: ../../library/decimal.rst:404
 msgid ""
 "Underscores are allowed for grouping, as with integral and floating-point "
 "literals in code."
 msgstr ""
+"允許使用底線進行分組，就像程式碼中的整數和浮點數字面值一樣。"
 
 #: ../../library/decimal.rst:408
 msgid ""
@@ -652,6 +685,10 @@ msgid ""
 "compared, sorted, and coerced to another type (such as :class:`float` or :"
 "class:`int`)."
 msgstr ""
+"Decimal 浮點數物件與其他內建數值型別（如 :class:`float` 和 :class:`int`）共享"
+"許多屬性。所有常用的數學運算和特殊方法都適用。同樣地，decimal 物件可以被複製、"
+"pickle 序列化、列印、用作字典鍵、用作集合元素、比較、排序，以及強制轉換為其他"
+"型別（如 :class:`float` 或 :class:`int`）。"
 
 #: ../../library/decimal.rst:415
 msgid ""
@@ -660,6 +697,8 @@ msgid ""
 "applied to Decimal objects, the sign of the result is the sign of the "
 "*dividend* rather than the sign of the divisor::"
 msgstr ""
+"Decimal 物件的算術運算與整數和浮點數的算術運算之間有一些小差異。當餘數運算子 "
+"``%`` 應用於 Decimal 物件時，結果的符號是 *被除數* 的符號，而不是除數的符號：:"
 
 #: ../../library/decimal.rst:420
 msgid ""
@@ -679,6 +718,8 @@ msgid ""
 "integer part of the true quotient (truncating towards zero) rather than its "
 "floor, so as to preserve the usual identity ``x == (x // y) * y + x % y``::"
 msgstr ""
+"整數除法運算子 ``//`` 的行為類似，回傳真商的整數部分（向零截斷）而不是其底數，"
+"以保持通常的恆等式 ``x == (x // y) * y + x % y``：:"
 
 #: ../../library/decimal.rst:429
 msgid ""
@@ -697,6 +738,8 @@ msgid ""
 "The ``%`` and ``//`` operators implement the ``remainder`` and ``divide-"
 "integer`` operations (respectively) as described in the specification."
 msgstr ""
+"``%`` 和 ``//`` 運算子分別實作規格中描述的 ``remainder`` 和 ``divide-integer`` "
+"運算。"
 
 #: ../../library/decimal.rst:438
 msgid ""
@@ -708,6 +751,11 @@ msgid ""
 "This avoids confusing results when doing equality comparisons between "
 "numbers of different types."
 msgstr ""
+"Decimal 物件通常不能在算術運算中與浮點數或 :class:`fractions.Fraction` 實例"
+"結合：例如，嘗試將 :class:`Decimal` 與 :class:`float` 相加會引發 :exc:"
+"`TypeError`。但是，可以使用 Python 的比較運算子來比較 :class:`Decimal` 實例 "
+"``x`` 與另一個數字 ``y``。這避免了在不同型別的數字之間進行相等比較時產生"
+"令人困惑的結果。"
 
 #: ../../library/decimal.rst:446
 msgid ""
