MongoDB\BSON\UTCDateTime::__construct

(mongodb >=1.0.0)

MongoDB\BSON\UTCDateTime::__construct — Construye un nuevo 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 desde la época UNIX (1 de enero de 1970). Los valores negativos representan fechas anteriores a 1970. Este valor puede ser proporcionado como un int de 64 bits. Para la compatibilidad en sistemas de 32 bits, este parámetro también puede ser proporcionado como una MongoDB\BSON\Int64.

Si el argumento es un DateTimeInterface, el número de milisegundos desde la época UNIX se derivará de este valor.

Si este argumento es null, la hora actual se utilizará por omisión.

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 string ni float.

PECL mongodb 1.20.0
El argumento milliseconds acepta ahora un objeto MongoDB\BSON\Int64 (para compatibilidad con las plataformas de 32 bits). Especificar una string o un float está deprecado.

PECL mongodb 1.2.0
El argumento milliseconds es opcional y por omisión es null (es decir, la hora actual). El argumento también acepta un DateTimeInterface, que puede ser utilizado para calcular el número de milisegundos desde la época UNIX. Anteriormente, solo se aceptaban los tipos int, float y string.

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

Ejemplos

Ejemplo #1 Ejemplo con 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

» BSON Types: Date