IntlCalendar::isEquivalentTo

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

IntlCalendar::isEquivalentTo — Verifica se outro calendário é igual exceto pelo horário

Descrição

Estilo orientado a objetos

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

Estilo procedural

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

Retorna se este objeto e o objeto informado são equivalentes para todos os propósitos exceto pelo horário definido neles. As localidades não precisam corresponder, desde que nenhuma mudança no comportamento resulte em diferenças. Isto inclui o fuso horário, se o modo leniente está definido, as configurações de horários de relógio repetidos e saltados, os dias da semana onde o final de semana inicia e termina e os horários onde tais transições ocorrem. A comparação também pode incluir outras configurações específicas de calendário, tal como o instante de transição do calendário juliano para o gregoriano.

Parâmetros

calendar

Uma instância de IntlCalendar.

other

O outro calendário com o qual a comparação será realizada.

Valor Retornado

Assumindo que não haja erros de argumentos, retorna true se os calendários forem equivalentes exceto possivelmente pelo horário definido neles.

Exemplos

Example #1 IntlCalendar::isEquivalentTo()

<?php
$cal1 = IntlCalendar::createInstance('Europe/Lisbon', 'pt_BR');
$cal2 = IntlCalendar::createInstance('Europe/Lisbon', 'en_US');
$cal2->clear();

var_dump($cal1->isEquivalentTo($cal2)); // true

$cal3 = IntlCalendar::createInstance('Europe/Lisbon', 'es_ES');
var_dump($cal1->isEquivalentTo($cal3)); // false
var_dump($cal1->getFirstDayOfWeek(),    // 1 (domingo)
$cal3->getFirstDayOfWeek());            // 2 (segunda-feira)

O exemplo acima produzirá:

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

Veja Também