(PHP 5 >= 5.2.0, PHP 7, PHP 8)
DateTime::__construct -- date_create — 返回一個(gè)新的 DateTime 對象
面向對象風(fēng)格
過(guò)程化風(fēng)格
返回一個(gè)新的 DateTime 對象。
time日期/時(shí)間字符串。正確格式的說(shuō)明詳見(jiàn) 日期與時(shí)間格式。
如果這個(gè)參數為字符串 "now" 表示獲取當前時(shí)間。
如果同時(shí)指定了 $timezone 參數，那么獲取指定時(shí)區的當前時(shí)間。
timezone
DateTimeZone 對象，
表示要獲取哪個(gè)時(shí)區的 $time。
如果省略了 $timezone 參數，
那么會(huì )使用當前時(shí)區。
注意:
當
$time參數是 UNIX 時(shí)間戳 （例如@946684800）， 或者已經(jīng)包含時(shí)區信息 （例如2010-01-28T15:00:00+02:00）的時(shí)候，$timezone參數 和當前時(shí)區都將被忽略。
返回一個(gè)新的 DateTime 對象實(shí)例，或者在發(fā)生錯誤的時(shí)候返回
過(guò)程化風(fēng)格在失敗時(shí)返回 false。。
如果發(fā)生錯誤，會(huì )拋出 Exception。
| 版本 | 說(shuō)明 |
|---|---|
| 7.1 | 微秒部分不再是 '00000' 了，而是真實(shí)的微秒數據。 |
| 5.3.0 |
如果 time 參數不是一個(gè)有效的
日期/時(shí)間格式，
會(huì )拋出異常。
在之前的版本中是會(huì )發(fā)出一個(gè)錯誤。
|
示例 #1 DateTime::__construct() 例程
面向對象風(fēng)格
<?php
try {
$date = new DateTime('2000-01-01');
} catch (Exception $e) {
echo $e->getMessage();
exit(1);
}
echo $date->format('Y-m-d');
?>
過(guò)程化風(fēng)格
<?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');
?>
以上例程會(huì )輸出：
2000-01-01
示例 #2 DateTime::__construct() 的復雜用法
<?php
// 指定時(shí)間，但是使用電腦的時(shí)區
$date = new DateTime('2000-01-01');
echo $date->format('Y-m-d H:i:sP') . "\n";
// 指定時(shí)間和時(shí)區
$date = new DateTime('2000-01-01', new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// 使用當前時(shí)間以及電腦的時(shí)區
$date = new DateTime();
echo $date->format('Y-m-d H:i:sP') . "\n";
// 使用當前時(shí)間和指定的時(shí)區
$date = new DateTime(null, new DateTimeZone('Pacific/Nauru'));
echo $date->format('Y-m-d H:i:sP') . "\n";
// 使用 UNIX 時(shí)間戳作為時(shí)間，請注意這里的生成的 DateTime 對象對應的是 UTC 時(shí)區
$date = new DateTime('@946684800');
echo $date->format('Y-m-d H:i:sP') . "\n";
// 指定一個(gè)無(wú)效的時(shí)間，會(huì )自動(dòng)對應到有效的時(shí)間
$date = new DateTime('2000-02-30');
echo $date->format('Y-m-d H:i:sP') . "\n";
?>
以上例程的輸出類(lèi)似于：
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