php教程

php手册

The DateTimeZone class

(PHP 5 >= 5.2.0, PHP 7)

简介

Representation of time zone.

类摘要

DateTimeZone {

/* 常量 */

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 ;

/* 方法 */

public __construct ( string $timezone )

public getLocation ( void ) : array

public getName ( void ) : string

public getOffset ( DateTime $datetime ) : int

public getTransitions ([ int $timestamp_begin = PHP_INT_MIN [, int $timestamp_end = PHP_INT_MAX ]] ) : array

public static listAbbreviations ( void ) : 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.

php教程 php手册 php手册

The DateTimeZone class

简介

类摘要

预定义常量

Table of Contents

User Contributed Notes

php教程

php手册