DateTimeImmutable::createFromTimestamp

Unix タイムスタンプからインスタンスを生成する

説明

public static static DateTimeImmutable::createFromTimestamp(intfloat $timestamp)

Unix タイムスタンプからインスタンスを生成します。

返されるオブジェクトのタイムゾーンは、 new DateTimeImmutable('@' . $timestamp) と同様、 常に UTC オフセット +00:00 になります。 date_default_timezone_get が返すデフォルトのタイムゾーンは使われません。 別のタイムゾーンでの日時を得るには、返されたオブジェクトの DateTimeImmutable::setTimezone を呼び出してください。

パラメータ

timestamp
日付を表す Unix タイムスタンプ。 float の値も受け付けるため、マイクロ秒の精度を指定できます。

戻り値

新しい DateTimeImmutable インスタンスを返します。

エラー / 例外

timestamp が [PHP_INT_MIN, PHP_INT_MAX] の範囲外の場合、 DateRangeError がスローされます。

例

例1 DateTimeImmutable::createFromTimestamp の例

<?php
$date = DateTimeImmutable::createFromTimestamp(123.456789);
echo $date->format('Y-m-d H:i:s.u');
?>

上の例の出力は以下となります。

1970-01-01 00:02:03.456789

例2 結果をデフォルトのタイムゾーンに変換する

<?php
date_default_timezone_set('Europe/Amsterdam');

$date = DateTimeImmutable::createFromTimestamp(1700000000);
echo $date->format('Y-m-d H:i:s P e'), "\n";

$date = $date->setTimezone(new DateTimeZone(date_default_timezone_get()));
echo $date->format('Y-m-d H:i:s P e'), "\n";
?>

上の例の出力は以下となります。

2023-11-14 22:13:20 +00:00 +00:00
2023-11-14 23:13:20 +01:00 Europe/Amsterdam