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

函式名稱：IntlGregorianCalendar::createFromDate()

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

函式描述：建立一個IntlGregorianCalendar物件，表示給定的日期。

用法：

IntlGregorianCalendar::createFromDate(
    int $year,
    int $month,
    int $day,
    ?IntlTimeZone $timeZone = null
): IntlGregorianCalendar|false

引數：

• $year：表示年份的整數值。
• $month：表示月份的整數值。範圍從1到12。
• $day：表示日期的整數值。範圍從1到31。
• $timeZone（可選）：表示時區的IntlTimeZone物件。如果未提供時區，則使用預設時區。

返回值：

• 如果成功建立IntlGregorianCalendar物件，則返回該物件。
• 如果提供的日期無效，則返回false。

示例：

// 建立一個表示2022年1月1日的IntlGregorianCalendar物件
$calendar = IntlGregorianCalendar::createFromDate(2022, 1, 1);

// 建立一個表示2022年1月1日，時區為"Asia/Shanghai"的IntlGregorianCalendar物件
$timeZone = IntlTimeZone::createTimeZone("Asia/Shanghai");
$calendar = IntlGregorianCalendar::createFromDate(2022, 1, 1, $timeZone);

// 建立一個無效的IntlGregorianCalendar物件，返回false
$calendar = IntlGregorianCalendar::createFromDate(2022, 13, 1);

注意事項：

• IntlGregorianCalendar類是Intl擴充套件的一部分，因此在使用該函式之前，請確保已啟用該擴充套件。
• IntlGregorianCalendar類還提供了其他用於處理日期和時間的方法，請參考官方文件以獲取更多資訊。