Doc #71108 [Opn->Csd]: date_create() is NOT an alias for "new DateTime()"

Edit report at https://bugs.php.net/bug.php?id=71108&edit=1 ID: 71108 Updated by: git@php.net Reported by: public at grik dot net Summary: date_create() is NOT an alias for "new DateTime()" -Status: Open +Status: Closed Type: Documentation Problem Package: Date/time related Operating System: irrelevant PHP Version: Irrelevant Block user comment: N Private report: N New Comment: Automatic comment on behalf of derickr Revision: https://github.com/php/doc-en/commit/fc1c548fabb0c2e411ee2f7984a741a805d4b030 Log: Fixed bug #71108: date_create() is NOT an alias for 'new DateTime()' Previous Comments: ------------------------------------------------------------------------ [2015-12-13 10:46:26] public at grik dot net Description: ------------ --- From manual page: http://www.php.net/function.date-create --- date_create() is NOT an alias, It is closer to be named a factory. For the first hand, DateTime::__construct() can't be called, which is obvious. For another, there is a significant difference between date_create() and "new DateTime()" We write if (!($DateTime = date_create('garbage'))){ //process error } but try { $DateTime = new DateTime('garbage'); }catch(Exception $E){ ... } Test script: --------------- $ php -r 'var_dump(date_create("garbage"));' bool(false) $ php -r 'var_dump(new DateTime("garbage"));' Fatal error: Uncaught exception 'Exception' with message 'DateTime::__construct(): Failed to parse time string (garbage) at position 0 (s): The timezone could not be found in the database' in Command line code:1 Stack trace: #0 Command line code(1): DateTime->__construct('garbage') #1 {main} thrown in Command line code on line 1 ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=71108&edit=1