將 timestamp 轉成某時區的時間使用 setTimestamp + format

PHP 時區轉換

DDDDD

發佈於軟體開發筆記

更新於 2024/12/04發佈於 2023/12/05閱讀時間約 6 分鐘

這邊主要是遇到功能需要處理時區，雖然主管給的筆記已經寫得很完美了，但覺得還是得理解吸收後並記錄自己的筆記後，好像才能有效吸收到腦袋裡

在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;

將 timestamp 轉成某時區的時間使用 `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);
}