DateTime::createFromTimestamp

(PHP 8 >= 8.4.0)

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

Description

public static function DateTime::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 DateTime('@' . $timestamp). The default timezone, as returned by date_default_timezone_get(), is not used. To get the date and time in another timezone, call DateTime::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 DateTime instance.

Errors/Exceptions

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

Examples

Example #1 DateTime::createFromTimestamp() example

<?php
$date = DateTime::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 = DateTime::createFromTimestamp(1700000000);
echo $date->format('Y-m-d H:i:s P e'), "\n";

$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