IntlGregorianCalendar::createFromDateTime()函式—用法及示例

函式名：IntlGregorianCalendar::createFromDateTime()

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

用法：IntlGregorianCalendar::createFromDateTime() 函式用於建立一個 IntlGregorianCalendar 物件，該物件基於給定的 DateTime 物件。

語法：public static IntlGregorianCalendar IntlGregorianCalendar::createFromDateTime(DateTimeInterface $dateTime)

引數：

• $dateTime: 必需。一個實現了 DateTimeInterface 介面的 DateTime 物件。

返回值：返回一個 IntlGregorianCalendar 物件，或者在失敗時返回 FALSE。

示例：

// 建立一個 DateTime 物件
$dateTime = new DateTime("2022-01-01 12:00:00", new DateTimeZone("Asia/Shanghai"));

// 使用 IntlGregorianCalendar::createFromDateTime() 建立 IntlGregorianCalendar 物件
$calendar = IntlGregorianCalendar::createFromDateTime($dateTime);

// 檢查物件是否建立成功
if ($calendar !== false) {
    // 輸出 IntlGregorianCalendar 物件的屬性
    echo "Calendar Type: " . $calendar->getType() . "<br>";
    echo "First Day of Week: " . $calendar->getFirstDayOfWeek() . "<br>";
    echo "Minimal Days in First Week: " . $calendar->getMinimalDaysInFirstWeek() . "<br>";
} else {
    echo "Failed to create IntlGregorianCalendar object.";
}

輸出結果：

Calendar Type: gregorian
First Day of Week: 1
Minimal Days in First Week: 1

以上示例建立了一個 DateTime 物件，並使用 IntlGregorianCalendar::createFromDateTime() 函式基於該 DateTime 物件建立了一個 IntlGregorianCalendar 物件。然後，我們透過呼叫 IntlGregorianCalendar 物件的屬性方法來獲取相關資訊，如日曆型別、一週的第一天以及第一週的最少天數。如果建立物件失敗，則輸出相應的錯誤資訊。