DateTime::setTimezone

date_timezone_set

Sets the time zone for the DateTime object

&reftitle.description;

&style.oop;

public `DateTime` `DateTime::setTimezone` `DateTimeZone` `timezone`

&style.procedural;

`DateTime` `date_timezone_set` `DateTime` `object` `DateTimeZone` `timezone`

Sets a new timezone for a `DateTime` `object`.

Like `DateTimeImmutable::setTimezone` but works with `DateTime`.

The procedural version takes the `DateTime` object as its first argument.

&reftitle.parameters;
&date.datetime.description.modified;

`timezone`

- A `DateTimeZone` object representing the desired time zone.

&reftitle.returnvalues;

Returns the `DateTime` object for method chaining. The underlaying point-in-time is not changed when calling this method.

&reftitle.examples;

### `DateTime::setTimeZone` example

&style.oop;

    <?php
    $date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));
    echo $date->format('Y-m-d H:i:sP') . "\n";

    $date->setTimezone(new DateTimeZone('Pacific/Chatham'));
    echo $date->format('Y-m-d H:i:sP') . "\n";
    ?>

&style.procedural;

    <?php
    $date = date_create('2000-01-01', timezone_open('Pacific/Nauru'));
    echo date_format($date, 'Y-m-d H:i:sP') . "\n";

    date_timezone_set($date, timezone_open('Pacific/Chatham'));
    echo date_format($date, 'Y-m-d H:i:sP') . "\n";
    ?>

&examples.outputs;

    2000-01-01 00:00:00+12:00
    2000-01-01 01:45:00+13:45

&reftitle.seealso;

- `DateTimeImmutable::setTimezone`
- `DateTime::getTimezone`
- `DateTimeZone::__construct`