[函数]IntlCalendar::createInstance()函数—用法及示例

函数名：IntlCalendar::createInstance()

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

用法：IntlCalendar::createInstance() 函数用于创建一个新的 IntlCalendar 对象。

语法：public static IntlCalendar IntlCalendar::createInstance([mixed $time = NULL [, string $locale = "" ]])

参数：

• $time（可选）：要使用的时间。可以是一个时间戳（自 Unix 纪元以来的秒数），或者是一个 DateTime 对象。默认为当前时间。
• $locale（可选）：要使用的区域设置。默认为空字符串，表示使用默认的区域设置。

返回值：返回一个 IntlCalendar 对象，或者在失败时返回 FALSE。

示例：

// 创建一个新的 IntlCalendar 对象，并设置为当前时间
$calendar = IntlCalendar::createInstance();

// 创建一个新的 IntlCalendar 对象，并设置为指定时间（2022年1月1日）
$calendar = IntlCalendar::createInstance(mktime(0, 0, 0, 1, 1, 2022));

// 创建一个新的 IntlCalendar 对象，并设置为指定时间（使用 DateTime 对象）
$datetime = new DateTime('2022-01-01');
$calendar = IntlCalendar::createInstance($datetime);

// 创建一个新的 IntlCalendar 对象，并设置为指定时间和区域设置
$calendar = IntlCalendar::createInstance(mktime(0, 0, 0, 1, 1, 2022), 'en_US');

if ($calendar === false) {
    echo "创建 IntlCalendar 对象失败！";
} else {
    echo "成功创建 IntlCalendar 对象！";
}

注意：

• IntlCalendar::createInstance() 函数是静态方法，可以直接通过类名调用。
• 如果未提供 $time 参数，则默认使用当前时间。
• 如果未提供 $locale 参数，则默认使用默认的区域设置。
• IntlCalendar 对象可以用于执行各种日期和时间操作，如计算日期差异、格式化日期和时间、转换时区等。