【JavaScript ECMAScript】Temporal::Temporal.PlainDateTime.prototype.toPlainTimeインスタンスメソッドの使い方

Temporal.PlainDateTime.prototype.toPlainTime()メソッドは、Temporal.PlainDateTimeオブジェクトが持つ日付と時刻の情報から、時刻部分のみを抽出し、新しいTemporal.PlainTimeオブジェクトとして返します。Temporal.PlainDateTimeは、タイムゾーン情報を含まない日付と時刻の組み合わせを表すオブジェクトです。一方、Temporal.PlainTimeは、日付情報を含まず、時、分、秒といった純粋な時刻のみを表現するオブジェクトとなります。

このメソッドを利用することで、完全な日付時刻データから時刻情報だけを効率的に分離できます。例えば、「2023-10-27T10:30:00」というTemporal.PlainDateTimeインスタンスに対してtoPlainTime()を呼び出すと、「10:30:00」というTemporal.PlainTimeインスタンスが生成されて返されます。この処理によって、元のTemporal.PlainDateTimeオブジェクト自体が変更されることはなく、元の情報は安全に保たれます。

システム開発において、日付とは独立した時刻情報を扱いたい場合に、このメソッドは非常に有用です。例えば、毎日同じ時刻に発生するイベントの開始時刻や、タイムゾーンの影響を受けずに純粋な時刻のみを比較したい場合などに活用できます。日付と時刻を明確に区別して扱えるため、コードの可読性が向上し、時間関連のロジックをより堅牢かつ直感的に記述できるようになります。

Copy
1const plainDateTime = Temporal.PlainDateTime.from('2023-10-27T10:30:00');
2const plainTime = plainDateTime.toPlainTime();

引数なし

引数はありません

Temporal.PlainTime

このメソッドは、呼び出し元の Temporal.PlainDateTime オブジェクトの時刻部分のみを抽出した、新しい Temporal.PlainTime オブジェクトを返します。