[函数]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类还提供了其他用于处理日期和时间的方法，请参考官方文档以获取更多信息。