Construye un nuevo objeto UTCDateTime

Descripción

final public MongoDB\BSON\UTCDateTime::__construct(int|MongoDB\BSON\Int64|DateTimeInterface|null $milliseconds = null)

Parámetros

milliseconds (int|MongoDB\BSON\Int64|DateTimeInterface|null): Número de milisegundos transcurridos desde la época Unix (1 de enero de 1970). Los valores negativos representan fechas anteriores a 1970. Este valor puede proporcionarse como un int de 64 bits. Para compatibilidad en sistemas de 32 bits, este parámetro también puede proporcionarse como un MongoDB\BSON\Int64. Si el argumento es un DateTimeInterface, el número de milisegundos transcurridos desde la época Unix se derivará de ese valor. Si este argumento es null, por omisión se utilizará la hora actual.

Errores/Excepciones

Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.

Historial de cambios

Versión	Descripción
PECL mongodb 2.0.0	El parámetro `milliseconds` ya no acepta un argumento de tipo string o float.
PECL mongodb 1.20.0	El argumento `milliseconds` ahora acepta un objeto MongoDB\BSON\Int64 (para compatibilidad en plataformas de 32 bits). Especificar un string o float está obsoleto.
PECL mongodb 1.2.0	El argumento `milliseconds` es opcional y por omisión es `null` (es decir, hora actual). El argumento también acepta un DateTimeInterface, que puede usarse para derivar el número de milisegundos transcurridos desde la época Unix. Anteriormente, solo se aceptaban tipos int, float y string.

Ejemplos

Ejemplo #1 Ejemplo de MongoDB\BSON\UTCDateTime::__construct()

<?php

var_dump(new MongoDB\BSON\UTCDateTime);

var_dump(new MongoDB\BSON\UTCDateTime(new DateTime));

var_dump(new MongoDB\BSON\UTCDateTime(1416445411987));

?>

Resultado del ejemplo anterior es similar a:

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"
}

Ver también

» Tipos BSON: Fecha