DateTime::__construct

date_create

(PHP 5 >= 5.2.0, PHP 7)

DateTime::__construct -- date_create — 返回一个新的 DateTime 对象

说明

面向对象风格

public DateTime::__construct ([ string $time = "now" [, DateTimeZone $timezone = NULL ]] )

过程化风格

date_create ([ string $time = "now" [, DateTimeZone $timezone = NULL ]] ) : DateTime

返回一个新的 DateTime 对象。

参数

time

日期/时间字符串。正确格式的说明详见 日期与时间格式。

如果这个参数为字符串 "now" 表示获取当前时间。 如果同时指定了 $timezone 参数，那么获取指定时区的当前时间。

timezone

DateTimeZone 对象， 表示要获取哪个时区的 $time。

如果省略了 $timezone 参数， 那么会使用当前时区。

Note:

当 $time 参数是 UNIX 时间戳 （例如 @946684800）， 或者已经包含时区信息 （例如 2010-01-28T15:00:00+02:00）的时候， $timezone 参数 和当前时区都将被忽略。

返回值

返回一个新的 DateTime 对象实例，或者在发生错误的时候返回 过程化风格在失败时返回 FALSE。。

错误／异常

如果发生错误，会抛出 Exception。

更新日志

版本 说明
7.1 微秒部分不再是 '00000' 了，而是真实的微秒数据。
5.3.0 如果 time 参数不是一个有效的 日期/时间格式， 会抛出异常。 在之前的版本中是会发出一个错误。

范例

Example #1 DateTime::__construct() 例程

面向对象风格

<?php
try {
    $date = new DateTime('2000-01-01');
} catch (Exception $e) {
    echo $e->getMessage();
    exit(1);
}

echo $date->format('Y-m-d');
?>

过程化风格

<?php
$date = date_create('2000-01-01');
if (!$date) {
    $e = date_get_last_errors();
    foreach ($e['errors'] as $error) {
        echo "$error\n";
    }
    exit(1);
}

echo date_format($date, 'Y-m-d');
?>

以上例程会输出：

2000-01-01

Example #2 DateTime::__construct() 的复杂用法

<?php
// 指定时间，但是使用电脑的时区
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:sP') . "\n";

// 指定时间和时区
$date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";

// 使用当前时间以及电脑的时区
$date = new DateTime();
echo $date->format('Y-m-d H:i:sP') . "\n";

// 使用当前时间和指定的时区
$date = new DateTime(null, new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";

// 使用 UNIX 时间戳作为时间，请注意这里的生成的 DateTime 对象对应的是 UTC 时区
$date = new DateTime('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";

// 指定一个无效的时间，会自动对应到有效的时间
$date = new DateTime('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
?>

以上例程的输出类似于：

2000-01-01 00:00:00-05:00
2000-01-01 00:00:00+12:00
2010-04-24 10:24:16-04:00
2010-04-25 02:24:16+12:00
2000-01-01 00:00:00+00:00
2000-03-01 00:00:00-05:00

参见

相关文章
php datetime 返回一个新的 datetime 对象php datetime 设置 datetime 对象的日期php datetime 设置 datetime 对象的时间php datetime 以 unix 时间戳的方式设置 datetime 对象php datetime 设置 datetime 对象的时区php datetime 对一个 datetime 对象减去一定量的 日、月、年、小时、分钟和秒。php datetimezone 创建新的datetimezone对象php 类/对象 函数 返回由已定义类的名字所组成的数组php 类/对象 函数 返回一个数组包含所有已声明的接口php 类/对象 函数 返回所有已定义的 traits 的数组php 类/对象 函数 返回由对象属性组成的关联数组php 类/对象 函数 返回对象或类的父类名php oci8 函数 分配新的 collection 对象php oci8 函数 分配并返回一个新的游标（语句句柄）php postgresql 函数 返回大型对象的当前指针位置php spl 函数 返回指定对象的hash idphp mysqli 初始化一条语句并返回一个用于mysqli stmt prepare 调用 的对象php pdo 准备要执行的语句，并返回语句对象php pdo 执行 sql 语句，以 pdostatement 对象形式返回结果集php reflectionclass 返回 reflectionclass 对象字符串的表示形式。
关注编程学问公众号