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