HomeMenu
Jesus · Bible · HTML · CSS · JS · PHP · SVG · Applications

date_create_immutable

Description

The date_create_immutable of Date / Time for PHP returns new DateTimeImmutable object.

Syntax

date_create_immutable(
    string $datetime = "now",
    ?DateTimeZone $timezone = null
): DateTimeImmutable|false

Parameters

datetime

A date/time string.

timezone

A DateTimeZone object representing the timezone of $datetime.

If $timezone is omitted or null, the current timezone will be used.

Note: The $timezone parameter and the current timezone are ignored when the $datetime parameter either is a UNIX timestamp (e.g. @946684800) or specifies a timezone (e.g. 2010-01-28T15:00:00+02:00, or 2010-07-05T06:00:00Z).

Return

Returns a new DateTimeImmutable instance.

Examples

1 · void

<?

$return = date_create_immutable();

print_r($return);

DateTimeImmutable Object
(
    [date] => 2026-03-09 00:32:47.224979
    [timezone_type] => 3
    [timezone] => UTC
)

2 · datetime

<?

$datetime = "2001-02-03 04:05:06.000007";

$return = date_create_immutable($datetime);

print_r($return);

DateTimeImmutable Object
(
    [date] => 2001-02-03 04:05:06.000007
    [timezone_type] => 3
    [timezone] => UTC
)

3 · timezone

<?

$datetime = "now";
$timezone = timezone_open("America/Los_Angeles");

$return = date_create_immutable($datetime, $timezone);

print_r($return);

DateTimeImmutable Object
(
    [date] => 2026-03-08 17:32:47.350486
    [timezone_type] => 3
    [timezone] => America/Los_Angeles
)