Constrói um novo UTCDateTime

Descrição

Parâmetros

milliseconds (int|float|string|DateTimeInterface|null)

Número de milissegundos desde a época Unix (1º de janeiro de 1970). Valores negativos representam datas anteriores a 1970. Este valor pode ser fornecido como um int de 64 bits. Para compatibilidade com sistemas de 32 bits, este parâmetro também pode ser fornecido como um MongoDB\BSON\Int64.

Se o argumento for um DateTimeInterface, o número de milissegundos desde a época Unix será derivado desse valor.

Se este argumento for null, o horário atual será usado por padrão.

Erros/Exceções

Lança uma exceção MongoDB\Driver\Exception\InvalidArgumentException em caso de erro ao analisar argumentos.

Registro de Alterações

Versão	Descrição
PECL mongodb 1.20.0	O parâmetro `milliseconds` agora aceita um objeto MongoDB\BSON\Int64 (para compatibilidade com plataformas de 32 bits). Especificar um string ou um float tornou-se defasado.
PECL mongodb 1.2.0	O argumento `milliseconds` é opcional e o padrão é `null` (ou seja, horário atual). O argumento também aceita um DateTimeInterface, que pode ser usado para derivar o número de milissegundos desde a época Unix. Anteriormente, apenas os tipos int, float e string eram aceitos.

Exemplos

Example #1 Exemplo 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));

?>

O exemplo acima produzirá algo semelhante 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"
}

Veja Também

» Tipos BSON: Data