IntlGregorianCalendar::getGregorianChange()函式—用法及示例

函式名：IntlGregorianCalendar::getGregorianChange()

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

函式說明：該函式用於獲取國際化日曆物件的公曆變更日期。

用法：

public IntlGregorianCalendar::getGregorianChange(): DateTime|false

引數：無

返回值：返回一個 DateTime 物件，表示公曆變更日期。如果無法獲取變更日期，則返回 false。

示例：

// 建立一個國際化日曆物件
$calendar = new IntlGregorianCalendar('en_US');

// 獲取公曆變更日期
$gregorianChange = $calendar->getGregorianChange();

if ($gregorianChange) {
    echo "公曆變更日期：".$gregorianChange->format('Y-m-d');
} else {
    echo "無法獲取公曆變更日期";
}

輸出示例：

公曆變更日期：1582-10-15

注意事項：

• 該函式只適用於使用國際化日曆物件（IntlGregorianCalendar）的情況。
• 公曆變更日期是指從儒略曆（Julian calendar）轉換為公曆（Gregorian calendar）的日期，通常為1582年10月15日。但是，根據不同的歷法和地區，公曆變更日期可能會有所不同。
• 如果無法獲取公曆變更日期，函式將返回 false。
• 返回的公曆變更日期是一個 DateTime 物件，可以使用 DateTime 類的方法對其進行格式化和操作。