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

函式名稱：IntlDateFormatter::localtime() 

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

函式描述：IntlDateFormatter::localtime() 方法用於將給定的日期和時間字串轉換為本地時間。

用法：

public static IntlDateFormatter::localtime(string $text, int &$parse_pos = null, IntlCalendar &$calendar = null) : mixed

引數：

• $text：要轉換的日期和時間字串。
• $parse_pos：可選引數，用於儲存解析的字串位置的整數引用。
• $calendar：可選引數，用於指定要使用的日曆物件。

返回值：

• 如果解析成功，則返回一個表示本地時間的整數。
• 如果解析失敗，則返回 false。

示例：

$formatter = new IntlDateFormatter(
    'en_US',
    IntlDateFormatter::FULL,
    IntlDateFormatter::FULL,
    'America/New_York'
);

// 將日期和時間字串轉換為本地時間
$text = '2021-09-15 12:30:00';
$localTime = $formatter->localtime($text);
echo 'Local Time: ' . date('Y-m-d H:i:s', $localTime) . PHP_EOL;

// 獲取解析的字串位置
$parsePos = null;
$localTime = $formatter->localtime($text, $parsePos);
echo 'Parse Position: ' . $parsePos . PHP_EOL;

// 使用指定的日曆物件
$calendar = IntlCalendar::fromDateTime('2021-09-15 12:30:00');
$localTime = $formatter->localtime($text, $parsePos, $calendar);
echo 'Local Time with Custom Calendar: ' . date('Y-m-d H:i:s', $localTime) . PHP_EOL;

以上示例將輸出：

Local Time: 2021-09-15 12:30:00
Parse Position: 19
Local Time with Custom Calendar: 2021-09-15 12:30:00

注意：本地時間是相對於指定的時區和日曆物件而言的，因此結果可能會因系統設定或輸入引數的不同而有所不同。