DateTimeImmutable::setTimestamp

(PHP 5 >= 5.5.0, PHP 7, PHP 8)

DateTimeImmutable::setTimestamp — Unix タイムスタンプを用いて日付と時刻を設定する

説明

#[\NoDiscard(message: "as DateTimeImmutable::setTimestamp() does not modify the object itself")]
public function DateTimeImmutable::setTimestamp(int $timestamp): DateTimeImmutable

Unix タイムスタンプを用いて日付と時刻を設定し、古いものから新しい DateTimeImmutable オブジェクトを作成して返します。

パラメータ

timestamp: 日付を表す Unix タイムスタンプ。 DateTimeImmutable::modify() を @ フォーマットと共に使うと、 int の範囲外のタイムスタンプを設定できます。

戻り値

変更されたデータを持つ、新しい DateTimeImmutable オブジェクトを返します。

例

例1 DateTimeImmutable::setTimestamp() の例

オブジェクト指向型

<?php
$date = new DateTimeImmutable();
echo $date->format('U = Y-m-d H:i:s') . "\n";

$newDate = $date->setTimestamp(1171502725);
echo $newDate->format('U = Y-m-d H:i:s') . "\n";

上の例の出力は、たとえば以下のようになります。

1272508903 = 2010-04-28 22:41:43
1171502725 = 2007-02-14 20:25:25

参考

DateTimeImmutable::getTimestamp() - Unix タイムスタンプを取得する
DateTimeImmutable::setMicrosecond() - 時刻のマイクロ秒部分を設定する

関連キーワード:

DateTimeImmutable タイムスタンプ Unix setTimestamp 日付時刻 date modify timestamp format newDate setTime setTimezone NoDiscard message itself フォーマット範囲オブジェクト指向参考 getTimestamp setMicrosecond マイクロ