PHP5.5起,DateTime类实现DateTimeInterface接口。
DateTime包括12个常量和除DateTimeInterface接口中定义的方法外的12个方法:
__construct:接受两个参数,一个是可选的日期时间字符串,如果字符串为now,表示获取当前时间。第二个参数是可选的DateTimeZone对象,用于指定获取哪个时区的时间,如果不传入此参数则使用默认为当前时间。当时间字符串为now时,如果同时传入了DateTimeZone对象,则会获取指定时区的当前时间。如果日期时间字符串为Unix时间戳或者已经包含了时区信息,则会忽略传入的DateTimeZone对象以及当前时区,返回一个新的DateTime对象,如果失败返回false。PHP5.3起,如果日期时间字符串格式错误会抛出异常,在此之前则是产生一个错误。PHP7.1起,微秒部分不再是0000而是返回真实的微秒数据。PHP5.2起,可用UNIX时间戳做为构造函数的参数生成新的DateTime对象。
add:增加一定的时间(天、月、年、小时、分钟以及秒)。接受一个DateInterval对象,将DateInterval对象的时间加到DateTime对象上。返回被修改的DateTime对象,若失败则返回false。
createFromFormat:静态方法,根据指定的格式解析日期时间字符串。接受三个参数,第一个为格式字符串,第二个参数为日期时间字符串,第三个参数为可选的DateTimeZone对象,用于指定获取哪个时区的时间,如果不传入此参数,且日期时间字符串中不包含时区信息则使用默认为当前时间。如果日期时间字符串为Unix时间戳或者已经包含了时区信息,则会忽略传入的DateTimeZone对象以及当前时区。如果格式字符串中存在不可识别的字符,会导致解析失败,并在返回的结果中附加一个错误信息,可以通过getLastErrors方法查看解析是否存在错误。返回一个DateTime对象,如果失败返回false。
getLastErrors:静态方法,获取解析日期时间字符串的过程中发生的警告和错误信息。返回一个数组,包含警告数量,警告信息,错误数量,错误信息,其中警告信息与错误信息是数组,数组的键为产生警告或错误的字符位置,值为具体警告或错误信息。
modify:修改日期时间对象的值,根据传入的日期时间字符串,修改DateTime对象的值。
__set_state:魔术方法。
setDate:设置DateTime对象的日期,接受三个参数,分别为年、月、日。返回被修改的DateTime对象,失败则返回false。
setISODate:以ISO8601的格式设置日期,使用周和日做偏移量而不是月和日。接受三个参数,第一个是年,第二个是周,第三个是可选的每周的第几天,默认为1。返回被修改的DateTime对象,失败则返回false。
setTime:设置DateTime对象的时间,接受四个参数,分别为时、分、秒、微秒(PHP7.1起),其中秒和微秒为可选的,默认为0。返回被修改的DateTime对象,失败则返回false。
setTimestamp:以Unix时间戳的方式设置DateTime对象的日期和时间。返回被修改的DateTime对象,失败则返回false。
setTimezone:设置DateTime对象的时区。接受一个DateTimeZone对象,表示要设置的时区。返回被修改的DateTime对象,失败则返回false。
sub:与add相反,减去一定的时间(天、月、年、小时、分钟以及秒)。接受一个DateInterval对象,将DateInterval对象的时间加到DateTime对象上。返回被修改的DateTime对象,若失败则返回false。
<?php
$date=new DateTime("2018-1-2");
echo $date->format("Y-m-d H:i:s"),"\n";
$date=new DateTime("@1468531584");
echo $date->format("Y-m-d H:i:s"),"\n";
$interval=new DateInterval("P10D");
$date->add($interval);
echo $date->format("Y-m-d H:i:s"),"\n";
$date=DateTime::createFromFormat("Y-m-j","2018-11-02");
if($date!=false){
echo $date->format("Y-m-d H:i:s"),"\n";
}
$date->modify("+1 days");
echo $date->format("Y-m-d H:i:s"),"\n";
$date->setDate(2019,1,1);
echo $date->format("Y-m-d H:i:s"),"\n";
$date->setISODate(2019,10,3);
echo $date->format("Y-m-d H:i:s"),"\n";
$date->setTime(22,18,30);
echo $date->format("Y-m-d H:i:s"),"\n";
$date->setTimestamp(1485835131);
echo $date->format("Y-m-d H:i:s TP"),"\n";
$date->setTimezone(new DateTimeZone('Pacific/Chatham'));
echo $date->format("Y-m-d H:i:s TP"),"\n";
$interval=new DateInterval("P5D");
$date->sub($interval);
echo $date->format("Y-m-d H:i:s"),"\n";
$date=DateTime::createFromFormat("Y-m-j","2018年1月2日");
var_dump(DateTime::getLastErrors());
?>