【JavaScript ECMAScript】Temporal::Temporal.Duration.from静的メソッドの使い方
Temporal.Duration.from()静的メソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Temporal.Duration.from()メソッドは、期間（Duration）を表すTemporal.Durationオブジェクトを生成する静的メソッドです。これは、時間の長さを表現し、操作する際に、様々な形式の入力から一貫したTemporal.Durationインスタンスを作成するために使用されます。
このメソッドの主な目的は、異なる形式で指定された期間情報を正規化し、安全かつ正確に扱うことができるTemporal.Durationオブジェクトに変換することです。例えば、ISO 8601形式の期間文字列（"P1Y2M3DT4H5M6S"のように、1年2ヶ月3日4時間5分6秒といった期間を表す形式）や、年、月、日、時間、分、秒、ミリ秒、マイクロ秒、ナノ秒などの時間単位をプロパティとして持つJavaScriptのプレーンなオブジェクト（{ hours: 2, minutes: 30 }など）を引数として渡すことができます。
Temporal.Duration.from()は、与えられた入力を厳密に解析し、有効な期間情報のみを抽出して新しいTemporal.Durationオブジェクトとして返します。これにより、複数のソースから得られる時間データを標準化し、その後の日付・時刻計算で予測可能かつ信頼性の高い結果を得ることが可能になります。また、無効な形式の入力が与えられた場合にはエラーを発生させることで、プログラムの堅牢性を高める手助けをします。このメソッドは、時間量を明示的に定義し、複雑な時間計算を簡潔に行う上で非常に重要な役割を果たします。
構文(syntax)
1Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 45 });
引数(parameters)
item
- item: Temporal.DurationLike: 日、時、分、秒、ミリ秒、マイクロ秒、ナノ秒などの期間を表すオブジェクトまたはプリミティブ値
戻り値(return)
Temporal.Duration
指定された時間単位の組み合わせから、新しいTemporal.Durationオブジェクトを生成します。このオブジェクトは、年、月、日、時、分、秒、ミリ秒などの時間単位を保持します。