IntlCalendar::equals

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

IntlCalendar::equals — Vérifie si deux objets IntlCalendar sont égaux

Description

Style orienté objet

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

Style procédural

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

Retourne true si ce calendrier et celui fourni ont le même temps. La configuration, le type de calendrier, et les statuts des champs ne doivent pas être forcément les mêmes.

Liste de paramètres

calendar: Une instance IntlCalendar.
other: Le calendrier à comparer avec l'objet primaire.

Valeurs de retour

Retourne true si le temps courant est identique à celui de l'objet IntlCalendar ou false sinon.

En cas d&échec false est aussi retourné. Pour détecter les conditions d&erreur intl_get_error_code() doit être utilisé, ou paramétrer Intl pour lancer des exceptions.

Exemples

Exemple #1 Exemple avec IntlCalendar::equals()

<?php
ini_set('date.timezone', 'UTC');

$cal1 = IntlCalendar::createInstance(NULL, 'es_ES');
$cal2 = clone $cal1;

var_dump($cal1->equals($cal2)); //TRUE

//La locale n'est pas incluse dans la comparaison
$cal2 = IntlCalendar::createInstance(NULL, 'pt_PT');
$cal2->setTime($cal1->getTime());
var_dump($cal1->equals($cal2)); //TRUE

//Et les statuts des champs ne sont pas non plus inclus
$cal2->clear(IntlCalendar::FIELD_YEAR);
var_dump($cal1->isSet(IntlCalendar::FIELD_YEAR) ==
        $cal2->isSet(IntlCalendar::FIELD_YEAR)); //FALSE
var_dump($cal1->equals($cal2)); //TRUE

//Ni le type de calendrier
$cal2 = IntlCalendar::createInstance(NULL, 'es_ES@calendar=islamic');
$cal2->setTime($cal1->getTime());
var_dump($cal1->equals($cal2)); //TRUE

//Seul le temps l'est
$cal2 = clone $cal1;
$cal2->setTime($cal1->getTime() + 1.);
var_dump($cal1->equals($cal2)); //FALSE