IntlCalendar::equals

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

IntlCalendar::equals — Comparar el instante de dos objetos IntlCalendar

Descripción

Estilo orientado a objetos

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

Estilo por procedimientos

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

Devuelve true si este calendario y el calendario dado tienen el mismo instante. La configuración, el tipo de calendario y los estados de los campos no tienen que ser los mismos.

Parámetros

cal: El recurso IntlCalendar.
other: El calendario con el que comparar el objeto primario.

Valores devueltos

Devuelve TRUE si el instante actual de ambos objetos IntlCalendar son el mismo, FALSE en caso contrario. El valor FALSE puede ser devuelto también en caso de error. Esto solamente puede ocurrir si se proporcionan argumentos erróneos. En cualquier caso, los dos casos se pueden distinguir llamando a intl_get_error_code().

Ejemplos

Ejemplo #1 IntlCalendar::equals()


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

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

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

// La configuración regional no se incluye en la comparación
$cal2 = IntlCalendar::createInstance(NULL, 'pt_PT');
$cal2->setTime($cal1->getTime());
var_dump($cal1->equals($cal2)); //TRUE

// Y los estados de los campos establecidos tampoco
$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 el tipo de calendario
$cal2 = IntlCalendar::createInstance(NULL, 'es_ES@calendar=islamic');
$cal2->setTime($cal1->getTime());
var_dump($cal1->equals($cal2)); //TRUE

// Solamente el instante
$cal2 = clone $cal1;
$cal2->setTime($cal1->getTime() + 1.);
var_dump($cal1->equals($cal2)); //FALSE