IntlCalendar::isEquivalentTo

(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)

IntlCalendar::isEquivalentTo — 別のカレンダーが、時刻を除いて等しいかを調べる

説明

オブジェクト指向型

public IntlCalendar::isEquivalentTo(IntlCalendar $other): bool

手続き型

intlcal_is_equivalent_to(IntlCalendar $calendar, IntlCalendar $other): bool

このオブジェクト、および指定されたオブジェクトが、設定されている時刻以外で等しいかを返します。振る舞いの変更がオブジェクトの不一致から起きない限り、ロケールが一致している必要はありません。比較されるのは、タイムゾーンや緩いモードが設定されているかどうか、実時間設定の繰り返し、実時間の設定の省略、週の始まりと終了の曜日、週の間の移行が起こる時刻があります。その他、カレンダー特有の設定も比較されます。たとえば、グレゴリオ暦/ユリウス暦への移行の瞬間などです。

パラメータ

calendar: IntlCalendar クラスのインスタンス。
other: 比較するカレンダー

戻り値

引数にエラーがなく、時刻以外はおそらくカレンダーが等しい場合に true を返します。

例

例1 IntlCalendar::isEquivalentTo()

<?php
$cal1 = IntlCalendar::createInstance('Europe/Lisbon', 'pt_PT');
$cal2 = IntlCalendar::createInstance('Europe/Lisbon', 'es_ES');
$cal2->clear();

var_dump($cal1->isEquivalentTo($cal2)); // true

$cal3 = IntlCalendar::createInstance('Europe/Lisbon', 'en_US');
var_dump($cal1->isEquivalentTo($cal3)); // false
var_dump($cal1->getFirstDayOfWeek(),    // 2 (Monday)
$cal3->getFirstDayOfWeek());            // 1 (Sunday)

上の例の出力は以下となります。

bool(true)
bool(false)
int(2)
int(1)

参考

IntlCalendar::equals() - ふたつの IntlCalendar オブジェクトの時刻を比較する