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

函式名：IntlCalendar::setLenient()

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

函式描述：設定是否在解析日期時寬鬆處理非法或不完整的日期。當設定為寬鬆模式時，IntlCalendar將嘗試使用合理的預設值來填充缺失的日期欄位，而不會丟擲錯誤。

用法：

bool IntlCalendar::setLenient(bool $isLenient)

引數：

• $isLenient：一個布林值，指示是否啟用寬鬆模式。如果設定為true，則啟用寬鬆模式；如果設定為false，則禁用寬鬆模式。

返回值：

• 成功時返回true，失敗時返回false。

示例：

$calendar = IntlCalendar::createInstance();

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

// 解析日期
$result = $calendar->set(IntlCalendar::FIELD_YEAR, 2022);
if ($result === false) {
    echo "解析日期失敗";
} else {
    echo "解析日期成功";
}

// 禁用寬鬆模式
$calendar->setLenient(false);

// 解析非法日期
$result = $calendar->set(IntlCalendar::FIELD_MONTH, 13); // 13是一個非法的月份
if ($result === false) {
    echo "解析日期失敗";
} else {
    echo "解析日期成功";
}

在上面的示例中，我們首先建立了一個IntlCalendar例項。然後，透過呼叫setLenient(true)方法，啟用了寬鬆模式。接下來，我們使用set()方法解析了一個有效的日期，並輸出解析結果。然後，我們禁用了寬鬆模式，再次使用set()方法解析了一個非法的日期（月份為13），並輸出解析結果。在寬鬆模式下，解析失敗的時候會返回false，而在非寬鬆模式下，解析失敗的時候會丟擲一個異常。