【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.secondインスタンスアクセサプロパティの使い方

Temporal.ZonedDateTime.prototype.secondプロパティは、JavaScriptの新しい日付と時刻APIであるTemporalにおいて、タイムゾーン情報を含む特定の時点の日時を表すTemporal.ZonedDateTimeオブジェクトが保持する「秒」の値を保持するプロパティです。このプロパティは、ZonedDateTimeインスタンスが表す時刻から、0から59までの範囲で秒の数値を正確に取得するために使用されます。

このプロパティはアクセサープロパティとして機能し、対象となるZonedDateTimeオブジェクトの内部状態に基づいて秒の値を計算して返します。例えば、const zdt = Temporal.ZonedDateTime.from('2024-07-20T10:30:45.123[America/New_York]'); のようにZonedDateTimeオブジェクトが生成された場合、zdt.secondにアクセスすると45という整数値が得られます。この値は、精密な時間管理が求められるシステム開発において非常に重要で、ログのタイムスタンプ、イベントのスケジュール調整、時間計算などの多様な場面で活用されます。

secondプロパティは読み取り専用であり、その値を直接変更することはできません。もし秒の値を変更した新しいZonedDateTimeオブジェクトが必要な場合は、withメソッドなど、Temporal APIが提供するイミュータブルな操作メソッドを使用し、元のオブジェクトを変更することなく新しいオブジェクトを生成する必要があります。これにより、時間情報の整合性を保ちつつ、柔軟な日時操作が可能となり、システムエンジニアはタイムゾーンを考慮した正確な時間情報を効率的に扱うことができます。

Copy
1const zonedDateTime = Temporal.ZonedDateTime.from({ year: 2023, month: 10, day: 27, hour: 15, minute: 30, second: 45, timeZone: 'Asia/Tokyo' });
2const secondValue = zonedDateTime.second;

引数なし

引数はありません

number

このプロパティは、UTCからの差（オフセット）が適用された日時を表す ZonedDateTime オブジェクトの秒を表す数値を返します。