IntlCalendar::setTimeZone()函式—用法及示例

函式名：IntlCalendar::setTimeZone()

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

用法：IntlCalendar::setTimeZone() 函式用於設定一個國際化日曆物件的時區。

語法：public bool IntlCalendar::setTimeZone(mixed $timeZone)

引數：

• $timeZone：要設定的時區。可以是時區識別符號的字串（如 "Asia/Shanghai"），也可以是一個 DateTimeZone 物件。

返回值：成功時返回 true，失敗時返回 false。

示例：

// 建立一個國際化日曆物件
$cal = IntlCalendar::createInstance();

// 設定時區為 "Asia/Shanghai"
$cal->setTimeZone("Asia/Shanghai");

// 獲取當前時區
$timeZone = $cal->getTimeZone();

echo $timeZone->getName(); // 輸出：Asia/Shanghai

// 使用 DateTimeZone 物件設定時區
$timezoneObj = new DateTimeZone("America/New_York");
$cal->setTimeZone($timezoneObj);

$timeZone = $cal->getTimeZone();
echo $timeZone->getName(); // 輸出：America/New_York

在上面的示例中，我們首先建立了一個國際化日曆物件 $cal，然後使用 setTimeZone() 函式將時區設定為 "Asia/Shanghai"。然後我們使用 getTimeZone() 函式獲取當前的時區，並輸出其名稱。

接下來，我們建立了一個 DateTimeZone 物件 $timezoneObj，表示 "America/New_York" 時區，並使用 setTimeZone() 函式將時區設定為 $timezoneObj。再次使用 getTimeZone() 函式獲取當前的時區，並輸出其名稱。

注意：在使用 setTimeZone() 函式之前，必須先建立一個國際化日曆物件。