From 00fa46506c2fda3ab47e40b2376b4b931404841b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9F=AF=E7=81=B0?= <i@kohai.top>
Date: Tue, 7 Jul 2026 17:35:13 +0800
Subject: [PATCH] Update Temporal.Duration section with examples

Clarified the description of Temporal.Duration and added examples for sorting durations.
---
 docs/temporal.md | 32 +++++++++++++-------------------
 1 file changed, 13 insertions(+), 19 deletions(-)

diff --git a/docs/temporal.md b/docs/temporal.md
index f287de4..1f98429 100644
--- a/docs/temporal.md
+++ b/docs/temporal.md
@@ -101,7 +101,7 @@ instant.toZonedDateTimeISO("America/New_York").toString()
 `Temporal.ZonedDateTime`表示某个时区的时间。它会在 ISO8601 的标准格式后面，添加时区后缀和历法后缀。
 
 ```javascript
-2020-08-05T20:06:13+09:00[Asia/Tokyo][u-ca=japanese]
+'2020-08-05T20:06:13+09:00[Asia/Tokyo][u-ca=japanese]'
 ```
 
 上面示例中，`2020-08-05T20:06:13+09:00`是 ISO8601 标准格式，`[Asia/Tokyo]`是时区后缀，`[u-ca=japanese]`是历法后缀，表示采用日本历法。
@@ -298,7 +298,7 @@ nextCNY.withCalendar("iso8601").toLocaleString() // 1/29/2025
 
 ## Temporal.Duration
 
-`Temporal.Duration`表示时长。
+`Temporal.Duration`表示一个持续的时间对象。
 
 ```javascript
 const duration = Temporal.Duration.from({
@@ -307,6 +307,17 @@ const duration = Temporal.Duration.from({
 });
 
 duration.total({ unit: 'second' }); // => 469200
+
+const durations = [
+  Temporal.Duration.from({ hours: 1 }),
+  Temporal.Duration.from({ hours: 2 }),
+  Temporal.Duration.from({ hours: 1, minutes: 30 }),
+  Temporal.Duration.from({ hours: 1, minutes: 45 }),
+];
+
+durations.sort(Temporal.Duration.compare);
+console.log(durations.map((d) => d.toString()));
+// [ 'PT1H', 'PT1H30M', 'PT1H45M', 'PT2H' ]
 ```
 
 ## Temporal.TimeZone
@@ -332,23 +343,6 @@ date.monthsInYear; // => 12
 date.daysInYear; // => 365
 ```
 
-## Temporal.Duration
-
-Temporal.Duration 表示一个持续的时间对象。
-
-```javascript
-const durations = [
-  Temporal.Duration.from({ hours: 1 }),
-  Temporal.Duration.from({ hours: 2 }),
-  Temporal.Duration.from({ hours: 1, minutes: 30 }),
-  Temporal.Duration.from({ hours: 1, minutes: 45 }),
-];
-
-durations.sort(Temporal.Duration.compare);
-console.log(durations.map((d) => d.toString()));
-// [ 'PT1H', 'PT1H30M', 'PT1H45M', 'PT2H' ]
-````
-
 ## 参考链接
 
 - [Temporal documentation](https://tc39.es/proposal-temporal/docs/)