IntlCalendar::isLenient()函式—用法及示例

函式名：IntlCalendar::isLenient()

適用版本：PHP 5 >= 5.5.0, PHP 7, PHP 8

用法：該函式用於檢查國際化日曆物件是否使用寬鬆模式。

語法：public bool IntlCalendar::isLenient ( void )

引數：該函式沒有引數。

返回值：如果國際化日曆物件使用寬鬆模式，則返回true；否則返回false。

示例：

// 建立一個Gregorian（公曆）日曆物件
$calendar = IntlCalendar::createInstance('America/New_York', 'en_US');

// 設定是否使用寬鬆模式
$calendar->setLenient(true);

// 檢查是否使用寬鬆模式
if ($calendar->isLenient()) {
    echo "該國際化日曆物件當前使用寬鬆模式。\n";
} else {
    echo "該國際化日曆物件當前不使用寬鬆模式。\n";
}

上述示例中，我們首先建立了一個基於美國東部時區和英語美國地區的Gregorian（公曆）日曆物件。接著，我們使用setLenient()函式將該日曆物件設定為使用寬鬆模式。最後，透過呼叫isLenient()函式來檢查該日曆物件是否使用寬鬆模式，並根據返回值輸出相應的提示資訊。

請注意，寬鬆模式是一種允許非法日期的模式，例如將月份設定為13或將天數設定為32。在寬鬆模式下，這些非法日期會被自動調整為合法日期。如果不使用寬鬆模式，則會丟擲異常來表示非法日期。