IntlCalendar::equals
(PHP 5 >= 5.5.0, PHP 7, PHP 8, PECL >= 3.0.0a1)
IntlCalendar::equals — Comparar el instante de dos objetos IntlCalendar
Descripción
Estilo orientado a objetos
Estilo por procedimientos
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
add a note
