IntlTimeZone::getEquivalentID()函式—用法及示例

函式名稱：IntlTimeZone::getEquivalentID()

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

函式用法：IntlTimeZone::getEquivalentID() 函式用於獲取與當前時區等效的時區識別符號。

語法：public static IntlTimeZone::getEquivalentID(string $zoneId, int $index) : string|false

引數：

• $zoneId：要查詢的時區識別符號，例如 "America/New_York"。
• $index：要獲取的等效時區的索引。如果 $index 為 0，則返回與當前時區最接近的等效時區的識別符號。如果 $index 大於 0，則返回下一個等效時區的識別符號。如果 $index 小於 0，則返回前一個等效時區的識別符號。

返回值：

• 如果成功，返回一個字串，表示與當前時區等效的時區識別符號。
• 如果失敗，返回 false。

示例：

$zoneId = 'America/New_York';
$index = 0;

$equivalentId = IntlTimeZone::getEquivalentID($zoneId, $index);

if ($equivalentId !== false) {
    echo "與當前時區等效的時區識別符號為：$equivalentId";
} else {
    echo "獲取等效時區失敗";
}

輸出：

與當前時區等效的時區識別符號為：America/Toronto

上述示例中，我們使用 IntlTimeZone::getEquivalentID() 函式獲取了與 "America/New_York" 時區等效的時區識別符號。由於 $index 設定為 0，所以返回與當前時區最接近的等效時區的識別符號。最後，我們將結果輸出到螢幕上。

請注意，由於時區資訊的變動，不同的 PHP 版本可能會返回不同的結果。因此，在使用該函式時，請確保你的 PHP 版本符合要求，並且時區資料庫已正確安裝。