Php/docs/mongodb-bson-utcdatetime.construct
MongoDB\BSON\UTCDateTime::__construct
(mongodb >=1.0.0)
MongoDB\BSON\UTCDateTime::__construct — Construct a new UTCDateTime
Description
final public MongoDB\BSON\UTCDateTime::__construct
([ int|float|string|DateTimeInterface $milliseconds
= NULL
] )
Parameters
milliseconds
(int|float|string|DateTimeInterface)Number of milliseconds since the Unix epoch (Jan 1, 1970). Negative values represent dates before 1970. This value may be provided as a 64-bit int. For compatibility on 32-bit systems, this parameter may also be provided as a float or string.
If the argument is a DateTimeInterface, the number of milliseconds since the Unix epoch will be derived from that value. Note that in versions of PHP versions before 7.1.0, DateTime and DateTimeImmutable objects constructed from the current time did not incorporate sub-second precision.
If this argument is
NULL
, the current time will be used by default.
Errors/Exceptions
- Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.
Changelog
Version | Description |
---|---|
PECL mongodb 1.2.0 | The milliseconds argument is optional and
defaults to |
Examples
Example #1 MongoDB\BSON\UTCDateTime::__construct() example
<?phpvar_dump(new MongoDB\BSON\UTCDateTime);var_dump(new MongoDB\BSON\UTCDateTime(new DateTime));var_dump(new MongoDB\BSON\UTCDateTime(1416445411987));?>
The above example will output something similar to:
object(MongoDB\BSON\UTCDateTime)#1 (1) { ["milliseconds"]=> string(13) "1484852905560" } object(MongoDB\BSON\UTCDateTime)#1 (1) { ["milliseconds"]=> string(13) "1484852905560" } object(MongoDB\BSON\UTCDateTime)#1 (1) { ["milliseconds"]=> string(13) "1416445411987" }