The DateTimeZone class

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

简介

Representation of time zone.

类摘要

DateTimeZone {

/* 常量 */

const int AFRICA = 1 ;

const int AMERICA = 2 ;

const int ANTARCTICA = 4 ;

const int ARCTIC = 8 ;

const int ASIA = 16 ;

const int ATLANTIC = 32 ;

const int AUSTRALIA = 64 ;

const int EUROPE = 128 ;

const int INDIAN = 256 ;

const int PACIFIC = 512 ;

const int UTC = 1024 ;

const int ALL = 2047 ;

const int ALL_WITH_BC = 4095 ;

const int PER_COUNTRY = 4096 ;

/* 方法 */

public __construct ( string $timezone )

public getLocation ( ) : array

public getName ( ) : string

public getOffset ( DateTime $datetime ) : int

public getTransitions ( int $timestampBegin = PHP_INT_MIN , int $timestampEnd = PHP_INT_MAX ) : array|false

public static listAbbreviations ( ) : array

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

}

预定义常量

DateTimeZone::AFRICA: Africa time zones.
DateTimeZone::AMERICA: America time zones.
DateTimeZone::ANTARCTICA: Antarctica time zones.
DateTimeZone::ARCTIC: Arctic time zones.
DateTimeZone::ASIA: Asia time zones.
DateTimeZone::ATLANTIC: Atlantic time zones.
DateTimeZone::AUSTRALIA: Australia time zones.
DateTimeZone::EUROPE: Europe time zones.
DateTimeZone::INDIAN: Indian time zones.
DateTimeZone::PACIFIC: Pacific time zones.
DateTimeZone::UTC: UTC time zones.
DateTimeZone::ALL: All time zones.
DateTimeZone::ALL_WITH_BC: All time zones including backwards compatible.
DateTimeZone::PER_COUNTRY: Time zones per country.

DateTimeZone::__construct — 创建新的DateTimeZone对象
DateTimeZone::getLocation — 返回与时区相关的定位信息。
DateTimeZone::getName — 返回时区名称。
DateTimeZone::getOffset — 返回相对于 GMT 的时差。
DateTimeZone::getTransitions — Returns all transitions for the timezone
DateTimeZone::listAbbreviations — 返回一个包含 dst (夏令时)，时差和时区信息的关联数组。
DateTimeZone::listIdentifiers — 返回一个包含了所有时区标示符的索引数组。

User Contributed Notes

bradm at inmotionhosting dot com 28-Mar-2018 01:43


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

                                    )

ryan at amst dot com 21-Aug-2015 07:45


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.

The DateTimeZone class

简介

类摘要

预定义常量

Table of Contents

User Contributed Notes