【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.withインスタンスメソッドの使い方
Temporal.ZonedDateTime.prototype.with()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
Temporal.ZonedDateTime.prototype.with()メソッドは、既存のTemporal.ZonedDateTimeオブジェクトの日付、時刻、またはタイムゾーンの情報を変更し、新しいZonedDateTimeオブジェクトを作成するメソッドです。このメソッドは、元のオブジェクトを変更するのではなく、指定された部分だけを更新した新たなオブジェクトを生成します。これにより、元のデータの整合性を保ちながら、異なる日時表現を安全に扱えます。
引数には、年、月、日、時、分、秒といった日時フィールドや、新しいタイムゾーンを指定するオブジェクトを渡します。例えば、ある日付の年を特定の値に変更したり、タイムゾーンを別の地域に設定したりすることが可能です。
本メソッドは、複数のタイムゾーンを扱うシステムや、サマータイムなどの日時ルールが適用される環境下で、正確な日時調整を行う際に特に有用です。開発者はこの機能を利用することで、タイムゾーンを考慮した複雑な日時計算を安全かつ直感的に実装できます。
公式リファレンス: Temporal.ZonedDateTime.prototype.with()
構文(syntax)
1zonedDateTime.with(temporalPartial, options)
引数(parameters)
temporalZonedDateTimeLike, options = {}
- temporalZonedDateTimeLike:
Temporal.ZonedDateTimeオブジェクト、またはTemporal.ZonedDateTimeオブジェクトとして解釈できるオブジェクト。このオブジェクトは、新しいTemporal.ZonedDateTimeを作成するために使用されます。 - options = {}: オプションを指定するオブジェクト。時間帯、年、月、日、時、分、秒、ミリ秒、マイクロ秒、ナノ秒などのプロパティを設定または変更するために使用されます。デフォルトは空のオブジェクトです。
戻り値(return)
Temporal.ZonedDateTime
このメソッドは、指定された日付・時刻・タイムゾーン情報に基づいて、新しい Temporal.ZonedDateTime オブジェクトを返します。元の Temporal.ZonedDateTime オブジェクトは変更されません。