DateTimeImmutable::createFromTimestamp

(PHP 8 >= 8.4.0)

DateTimeImmutable::createFromTimestamp — Creates an instance from a Unix timestamp

Description

public static function DateTimeImmutable::createFromTimestamp(int|float $timestamp): static

Creates an instance from a Unix timestamp.

The timezone of the returned object is always the UTC offset +00:00, as with new DateTimeImmutable('@' . $timestamp). The default timezone, as returned by date_default_timezone_get(), is not used. To get the date and time in another timezone, call DateTimeImmutable::setTimezone() on the returned object.

Parameters

timestamp

Unix timestamp representing the date. A float value is also accepted which allows for microsecond precision.

Return Values

Returns a new DateTimeImmutable instance.

Errors/Exceptions

If the timestamp is outside the range [PHP_INT_MIN, PHP_INT_MAX], a DateRangeError is thrown.

Examples

Example #1 DateTimeImmutable::createFromTimestamp() example

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

The above example will output:

1970-01-01 00:02:03.456789

Example #2 Converting the result to the default timezone

<?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";
?>

The above example will output:

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