這邊主要是遇到功能需要處理時區,雖然主管給的筆記已經寫得很完美了,但覺得還是得理解吸收後並記錄自己的筆記後,好像才能有效吸收到腦袋裡
在PHP處理時區轉換的時候常見使用方式是使用 DateTime 這個Class
設定時區
透過實例化後可以傳入一個時間並指定他要在哪個時區,舉例如下
$dateTime = new DateTime('2022-01-10 12:00:00', new DateTimeZone('Asia/Taipei'));
這邊程式碼結果為台北時間 2022-01-10 12:00:00
,如果沒有特別指定時間,預設是當下,如果沒有特別指定時區,就看 PHP 所在系統預設的時區,另外初始化 DateTimeZone
除了輸入特定城市的時區外,也可以使用 UTC 加減時間表示,例如 UTC +8 時區可用 new DateTimeZone('+0800')
表示、UTC -4 時區可用 new DateTimeZone('-0400')
表示,舉例如下
$dateTime = new DateTime('2022-01-10 12:00:00', '-0400');
轉換時區
而在轉換時區的時候可以使用 setTimezone
方法,將時區作轉換,舉例如下
把本地預設時區 2022-01-10 12:00:00
轉成紐約時區的時間
$dateTime = new DateTime('2022-01-10 12:00:00');
$dateTime->setTimezone(new DateTimeZone('America/New_York'))->format('Y-m-d H:i:s');
把台北時區 2022-01-10 12:00:00
轉成紐約時區的時間
$dateTime = new DateTime('2022-01-10 12:00:00', new DateTimeZone('Asia/Taipei'));
$dateTime->setTimezone(new DateTimeZone('America/New_York'))->format('Y-m-d H:i:s');
//2022-01-09 23:00:00
取得unix timestamp
而在設計API的時候,使用datetime(2022-01-10 12:00:00)
的日期,會有時區問題,就必須要做轉換有點麻煩,故通常都會使用unix timestamp(時間戳)
的方式,而時間戳是由格林威治時間1970年1月1日(00:00:00)至今的毫秒數。也稱之為「Unix Timestamp」,為一種時間表示方式。同時也表示UTC+0這個地方的時區。
而時間戳記一般為10位和13位,10位的單位是秒,13位的是毫秒,一般開發用到的都是10位時間戳。
而使用DateTime 這個Class,可以使用getTimestamp
方法來取得unix timestamp,舉例如下:
$dateTime = new DateTime('2022-01-10 12:00:00');
$dateTime->getTimestamp();
//等同於 strtotime('2022-01-10 12:00:00');
取得台北時區 2022-01-10 12:00:00
的 unix timestamp
$dateTime = new DateTime('2022-01-10 12:00:00', new DateTimeZone('Asia/Taipei'));
$dateTime->getTimestamp();
而在PHP中,DateTime 類別預設只支援秒級別的時間戳,而不是毫秒等級,而最簡單的做法就是將$dateTime->getTimestamp()
; 直接乘上1000
$timestampInSeconds = $dateTime->getTimestamp();
$timestampInMilliseconds = $timestampInSeconds * 1000;
setTimestamp
+ format
將 timestamp 1656604800 轉成台北時區時間
$dateTime = new DateTime()
$dateTime->setTimezone(new DateTimeZone('Asia/Taipei'))->setTimestamp(1656604800)->format('Y-m-d H:i:s')
//2022-07-01 00:00:00
最後則可以試著將共用的方法,包裝成一個helper.php
,來做時區的處理
// 取得Timestamp
function getTimestamp(string $time, string $timezone = 'Asia/Taipei')
{
$dateTime = new DateTime($time, new DateTimeZone($timezone));
return $dateTime->getTimestamp();
}
function setDateTime(int $timestamp, string $timezone = 'Asia/Taipei', string $format = 'Y-m-d H:i:s')
{
$dateTime = new DateTime();
return $dateTime->setTimezone(new DateTimeZone($timezone))->setTimestamp($timestamp)->format($format);
}