【JavaScript ECMAScript】Temporal::Temporal.ZonedDateTime.prototype.equalsインスタンスメソッドの使い方
Temporal.ZonedDateTime.prototype.equals()インスタンスメソッドの使い方について、初心者にもわかりやすく解説します。
基本的な使い方
Temporal.ZonedDateTime.prototype.equals()メソッドは、JavaScriptのTemporal APIにおいて、二つのTemporal.ZonedDateTimeオブジェクトが同一の特定の瞬間を、同じタイムゾーンとカレンダーシステムの下で表しているかどうかを厳密に比較するメソッドです。このメソッドは、比較したい別のTemporal.ZonedDateTimeオブジェクトを引数として受け取ります。
戻り値は真偽値（trueまたはfalse）です。両方のTemporal.ZonedDateTimeオブジェクトが、完全に同じタイムゾーンに属し、同じカレンダーシステムを使用し、さらに地球上での特定の瞬間（エポックからの経過時間などで表現される時点）が完全に一致する場合にのみ、trueを返します。もしタイムゾーンが異なる場合、またはカレンダーシステムが異なる場合、あるいはタイムゾーンとカレンダーが同じでも表す瞬間がわずかでも異なる場合は、falseを返します。
例えば、「東京の2023年10月27日午前10時」と「ロンドンの2023年10月27日午前10時」は、時間コンポーネントは同じでもタイムゾーンが異なるため、このメソッドはfalseを返します。これは、同じ時刻に見えても、それらが地球上で実際に指し示す「瞬間」が異なるためです。このメソッドは、タイムゾーン情報を含む厳密な日時比較が必要なシステムにおいて、曖昧さのない正確な判定を行うために利用されます。
構文(syntax)
1zonedDateTime.equals(otherZonedDateTime)
引数(parameters)
other
- other: Temporal.ZonedDateTime: 比較対象となるTemporal.ZonedDateTimeオブジェクト
戻り値(return)
boolean
指定されたTemporal.ZonedDateTimeオブジェクトが、別のTemporal.ZonedDateTimeオブジェクトと、日付、時刻、およびタイムゾーン情報を含めて完全に一致するかどうかを示す真偽値（trueまたはfalse）を返します。