IntlDateFormatter::formatObject()函式—用法及示例

函式名：IntlDateFormatter::formatObject()

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

用法：這個函式用於將日期物件格式化為字串。它是IntlDateFormatter類的一個方法，該類是PHP國際化擴充套件（Intl）提供的一個類，用於處理日期和時間的國際化。

語法：public string IntlDateFormatter::formatObject ( mixed $object [, mixed $format = NULL [, mixed $locale = NULL ]] )

引數：

• object: 要格式化的日期物件。可以是DateTime物件、DateTimeImmutable物件或者UNIX時間戳（以秒為單位）。
• format: 可選引數，表示要應用的格式模式。如果未提供該引數，則使用IntlDateFormatter物件的預設格式。
• locale: 可選引數，表示要使用的區域設定。如果未提供該引數，則使用IntlDateFormatter物件的預設區域設定。

返回值：返回格式化後的日期字串。

示例：

$formatter = new IntlDateFormatter('en_US', IntlDateFormatter::FULL, IntlDateFormatter::FULL);
$date = new DateTime('2022-01-01 12:34:56');

echo $formatter->formatObject($date);
// 輸出：Saturday, January 1, 2022 at 12:34:56 PM GMT

echo $formatter->formatObject($date, IntlDateFormatter::SHORT);
// 輸出：1/1/22, 12:34 PM

echo $formatter->formatObject(time());
// 輸出：Saturday, January 1, 2022 at 12:34:56 PM GMT

上述示例中，我們首先建立了一個IntlDateFormatter物件，指定了區域設定為'en_US'，日期格式為FULL，時間格式為FULL。然後，我們建立了一個DateTime物件，表示2022年1月1日12時34分56秒。透過呼叫formatObject()方法，將日期物件格式化為字串並輸出。

在第二個示例中，我們傳遞了IntlDateFormatter::SHORT作為第二個引數，表示使用簡短的日期格式。輸出結果中的日期格式變為了短格式。

在第三個示例中，我們傳遞了time()函式的返回值作為日期物件，而不是直接傳遞DateTime物件。formatObject()方法也可以接受UNIX時間戳作為輸入。

請注意，要使用IntlDateFormatter類，需要安裝並啟用PHP的Intl擴充套件。