La función IntlCalendar::equals() es una función incorporada en PHP que se usa para comparar dos objetos de tiempo de IntlCalendar y devuelve verdadero si este calendario y el calendario dado tienen la misma fecha; de lo contrario, devuelve falso.
Sintaxis:
- Estilo orientado a objetos:
bool IntlCalendar::equals( IntlCalendar $other )
- Estilo procesal:
bool intlcal_equals( IntlCalendar $cal, IntlCalendar $other )
Parámetros:
- $cal: este parámetro contiene el recurso IntlCalendar.
- $other: este parámetro contiene la fecha y la hora del calendario para comparar con el objeto de la primera vez.
Valor devuelto: esta función devuelve VERDADERO si la hora actual de ambos objetos IntlCalendar es la misma; de lo contrario, devuelve FALSO.
El siguiente programa ilustra la función IntlCalendar::equals() en PHP:
Programa:
<?php
// Create an IntlCalendar from a DateTime object or string
$calendar1 = IntlCalendar::fromDateTime('2019-03-21 09:19:29');
$calendar2 = IntlCalendar::fromDateTime('2018-03-21 09:19:29');
// Use IntlCalendar::equals() function to compare time
// of two IntlCalendar objects and display result
var_dump($calendar1->equals($calendar2));
// Clone the DateTime of $calendar1
$calendar2 = clone $calendar1;
// Use IntlCalendar::equals() function to compare time
// of two IntlCalendar objects and display result
var_dump($calendar1->equals($calendar2));
// Create an instance of IntlCalendar
$calendar2 = IntlCalendar::createInstance(NULL, 'en_US');
// Set DateTime of $calendar2 to $calendar1
$calendar2->setTime($calendar1->getTime());
// Use IntlCalendar::equals() function to compare time
// of two IntlCalendar objects and display result
var_dump($calendar1->equals($calendar2));
// Clone the DateTime of $calendar1
$calendar2 = clone $calendar1;
// Set DateTime of $calendar2 to $calendar1
$calendar2->setTime($calendar1->getTime() - 10);
// Use IntlCalendar::equals() function to compare time
// of two IntlCalendar objects and display result
var_dump($calendar1->equals($calendar2));
?>
Producción:
bool(false) bool(true) bool(true) bool(false)
Referencia: https://www.php.net/manual/en/intlcalendar.equals.php