php8.5
Home/ Manual/ intl / intlcalendar/ IntlCalendar::isEquivalentTo

IntlCalendar::isEquivalentTo

PHP function Edit on GitHub ✎

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

Whether another calendar is equal but for a different time

Description

Oop

IntlCalendar::isEquivalentTo(IntlCalendar $other): bool

Procedural

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

Returns whether this and the given object are equivalent for all purposes except as to the time they have set. The locales do not have to match, as long as no change in behavior results from such mismatch. This includes the timezone, whether the lenient mode is set, the repeated and skipped wall time settings, the days of the week when the weekend starts and ceases and the times where such transitions occur. It may also include other calendar specific settings, such as the Gregorian/Julian transition instant.

Parameters

calendar

Intl-calendar

other

The other calendar against which the comparison is to be made.

Return Values

Assuming there are no argument errors, returns true if the calendars are equivalent except possibly for their set time.

Examples

IntlCalendar::isEquivalentTo()

php
<?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)

The above example will output:

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

See Also

  • IntlCalendar::equals

Source: reference/intl/intlcalendar/isequivalentto.xml · from the official PHP manual (php/doc-en)