Submit a Pull Request Report a Bug

A classe DateTimeZone

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

Introdução

Representação de um fuso horário.

Sinopse da classe

DateTimeZone {

/* Constantes */

const integer AFRICA = 1 ;

const integer AMERICA = 2 ;

const integer ANTARCTICA = 4 ;

const integer ARCTIC = 8 ;

const integer ASIA = 16 ;

const integer ATLANTIC = 32 ;

const integer AUSTRALIA = 64 ;

const integer EUROPE = 128 ;

const integer INDIAN = 256 ;

const integer PACIFIC = 512 ;

const integer UTC = 1024 ;

const integer ALL = 2047 ;

const integer ALL_WITH_BC = 4095 ;

const integer PER_COUNTRY = 4096 ;

/* Métodos */

public __construct ( string $timezone )

public getLocation ( ) : array

public getName ( ) : string

public getOffset ( DateTime $datetime ) : int

public getTransitions ( int $timestamp_begin = ? , int $timestamp_end = ? ) : array

public static listAbbreviations ( ) : array

public static listIdentifiers ( int $what = DateTimeZone::ALL , string $country = null ) : array

}

Constantes pré-definidas

DateTimeZone::AFRICA: Fusos horários da África.
DateTimeZone::AMERICA: Fusos horários da América.
DateTimeZone::ANTARCTICA: Fusos horários da Antártica.
DateTimeZone::ARCTIC: Fusos horários do Ártico.
DateTimeZone::ASIA: Fusos horários da Ásia.
DateTimeZone::ATLANTIC: Fusos horários do Atlântico.
DateTimeZone::AUSTRALIA: Fusos horários da Austrália.
DateTimeZone::EUROPE: Fusos horários Europeus.
DateTimeZone::INDIAN: Fusos horários Indianos.
DateTimeZone::PACIFIC: Fusos horários do Pacífico.
DateTimeZone::UTC: Fusos horários UTC.
DateTimeZone::ALL: Todos os fusos horários.
DateTimeZone::ALL_WITH_BC: Todos os fusos horários, incluindo retrocompatíveis.
DateTimeZone::PER_COUNTRY: Fusos horários por país.

Índice

DateTimeZone::__construct — Cria um novo objeto DateTimeZone
DateTimeZone::getLocation — Retorna informações da localização de um fuso horário
DateTimeZone::getName — Retorna o nome do fuso horário
DateTimeZone::getOffset — Retorna o deslocamento do fuso horário ao Horário de Greenwish (GMT)
DateTimeZone::getTransitions — Retorna todas as transições do fuso horário
DateTimeZone::listAbbreviations — Retorna um fuso horário contendo o indicativo do horário de verão(dst), o deslocamento e nome do fuso horário
DateTimeZone::listIdentifiers — Retorna um array numericamente indexado contendo todos os indenticadores de fuso horário

add a note

User Contributed Notes 2 notes

down

bradm at inmotionhosting dot com ¶

6 years ago


Seems like a significant differences between php 5.3 and 5.6:

php -r "new DateTimeZone( '-0400' );"
-------------                        --------------
- PHP 5.3.3 -                        - PHP 5.6.30 -
-------------                        --------------
DateTimeZone::__construct():        Works as expected.
Unknown or bad timezone (-0400)

php -r '$tz = new DateTimeZone( "EDT" ); echo $tz->getName();';
-------------                        --------------
- PHP 5.3.3 -                        - PHP 5.6.30 -
-------------                        --------------
America/New_York                    EDT

php -r '$tz = new DateTimeZone( "EDT" ); echo $tz->getName();';
-------------                        --------------
- PHP 5.3.3 -                        - PHP 5.6.30 -
-------------                        --------------
DateTimeZone Object                DateTimeZone Object
(                                    (
)                                    [timezone_type] => 2
                                    [timezone] => EDT
                                    )

down

-22

ryan at amst dot com ¶

8 years ago


It seems like as of PHP 5.5, creating a new DateTimeZone with a string like 'EDT' will cause DateTimeZone::getName() to return 'EDT' whereas prior to 5.5 it would convert it would have returned 'America/New_York'

This is of particular note when using a DateTimeZone object to change the timezone on a DateTime object.  Using a DateTimeZone object when set as shown above will cause the conversion to be wrong without throwing any errors.

add a note