Temporal.PlainTime
Temporal.PlainTime 物件表示一個沒有日期或時區的時間；例如，每天在同一時間發生的週期性事件。它從根本上表示為小時、分鐘、秒、毫秒、微秒和納秒值的組合。
描述
PlainTime 本質上是 Temporal.PlainDateTime 物件的時間部分，去除了日期資訊。由於日期和時間資訊之間沒有太多互動，因此所有關於時間屬性的通用資訊都記錄在此處。
RFC 9557 格式
PlainTime 物件可以使用 RFC 9557 格式進行序列化和解析，該格式是 ISO 8601 / RFC 3339 格式的擴充套件。字串具有以下形式：
HH:mm:ss.sssssssss
HH-
一個兩位數，從
00到23。它可能以時間指示符T或t為字首。 mm可選-
一個從
00到59的兩位數。預設為00。 ss.sssssssss可選-
一個從
00到59的兩位數。可以選擇後跟.或,和一到九位數字。預設為00。HH、mm和ss部分可以用:分隔或不用。你可以只省略ss或同時省略ss和mm，因此時間可以有三種形式：HH、HH:mm或HH:mm:ss.sssssssss。
作為輸入，你可以選擇包含日期、偏移量、時區識別符號和日曆，格式與 PlainDateTime 相同，但它們將被忽略。純日期字串將被拒絕。[key=value] 格式的其他註解也將被忽略，並且它們不得具有關鍵標誌。
序列化時，你可以配置小數秒位數。
建構函式
Temporal.PlainTime()實驗性-
透過直接提供底層資料來建立新的
Temporal.PlainTime物件。
靜態方法
Temporal.PlainTime.compare()實驗性-
返回一個數字（-1、0 或 1），指示第一個時間是在第二個時間之前、相同還是之後。等效於逐個比較小時、分鐘、秒、毫秒、微秒和納秒欄位。
Temporal.PlainTime.from()實驗性-
從另一個
Temporal.PlainTime物件、具有時間屬性的物件或 RFC 9557 字串建立新的Temporal.PlainTime物件。
例項屬性
這些屬性定義在 Temporal.PlainTime.prototype 上，並由所有 Temporal.PlainTime 例項共享。
Temporal.PlainTime.prototype.constructor-
建立例項物件的建構函式。對於
Temporal.PlainTime例項，初始值是Temporal.PlainTime()建構函式。 Temporal.PlainTime.prototype.hour實驗性-
返回一個從 0 到 23 的整數，表示此時間的小時部分。
Temporal.PlainTime.prototype.microsecond實驗性-
返回一個從 0 到 999 的整數，表示此時間的微秒（10-6 秒）部分。
Temporal.PlainTime.prototype.millisecond實驗性-
返回一個從 0 到 999 的整數，表示此時間的毫秒（10-3 秒）部分。
Temporal.PlainTime.prototype.minute實驗性-
返回一個從 0 到 59 的整數，表示此時間的分鐘部分。
Temporal.PlainTime.prototype.nanosecond實驗性-
返回一個從 0 到 999 的整數，表示此時間的納秒（10-9 秒）部分。
Temporal.PlainTime.prototype.second實驗性-
返回一個從 0 到 59 的整數，表示此時間的秒部分。
Temporal.PlainTime.prototype[Symbol.toStringTag]-
[Symbol.toStringTag]屬性的初始值是字串"Temporal.PlainTime"。此屬性在Object.prototype.toString()中使用。
例項方法
Temporal.PlainTime.prototype.add()實驗性-
返回一個新的
Temporal.PlainTime物件，表示此時間向前移動了給定持續時間（以可由Temporal.Duration.from()轉換的形式），必要時在時鐘上迴圈。 Temporal.PlainTime.prototype.equals()實驗性-
如果此時間的值與另一個時間（以可由
Temporal.PlainTime.from()轉換的形式）等效，則返回true，否則返回false。它們透過時間值進行比較。等效於Temporal.PlainTime.compare(this, other) === 0。 Temporal.PlainTime.prototype.round()實驗性-
返回一個新的
Temporal.PlainTime物件，表示此時間四捨五入到給定單位。 Temporal.PlainTime.prototype.since()實驗性-
返回一個新的
Temporal.Duration物件，表示從另一個時間（以可由Temporal.PlainTime.from()轉換的形式）到此時間的持續時間。如果另一個時間在此時間之前，則持續時間為正，如果之後則為負。 Temporal.PlainTime.prototype.subtract()實驗性-
返回一個新的
Temporal.PlainTime物件，表示此時間向後移動了給定持續時間（以可由Temporal.Duration.from()轉換的形式），必要時在時鐘上迴圈。 Temporal.PlainTime.prototype.toJSON()實驗性-
返回一個字串，以與呼叫
toString()相同的 RFC 9557 格式表示此時間。旨在由JSON.stringify()隱式呼叫。 Temporal.PlainTime.prototype.toLocaleString()實驗性-
返回一個字串，包含此時間對語言敏感的表示。
Temporal.PlainTime.prototype.toString()實驗性-
返回一個字串，以 RFC 9557 格式表示此時間。
Temporal.PlainTime.prototype.until()實驗性-
返回一個新的
Temporal.Duration物件，表示從此時間到另一個時間（以可由Temporal.PlainTime.from()轉換的形式）的持續時間。如果另一個時間在此時間之後，則持續時間為正，如果之前則為負。 Temporal.PlainTime.prototype.valueOf()實驗性Temporal.PlainTime.prototype.with()實驗性-
返回一個新的
Temporal.PlainTime物件，表示此時間的一些欄位被新值替換。
規範
| 規範 |
|---|
| Temporal # sec-temporal-plaintime-objects |
瀏覽器相容性
載入中…