MongoDB\BSON\UTCDateTime::__construct

(mongodb >=1.0.0)

MongoDB\BSON\UTCDateTime::__construct — Создает новый UTCDateTime

Описание

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

Список параметров

milliseconds (int|float|string|DateTimeInterface)

Количество миллисекунд со времен Unix (1 января 1970 г.). Отрицательные значения представляют даты до 1970 года. Это значение может быть представлено как 64-разрядный int. Для совместимости в 32-битных системах этот параметр также может быть представлен, как float или string.

Если аргумент является DateTimeInterface, из этого значения будет получено количество миллисекунд, прошедших с начала эпохи Unix. Обратите внимание, что в версиях PHP до 7.1.0 объекты DateTime и DateTimeImmutable, построенные по текущему времени, не включают в себя точность менее секунды.

Если этот аргумент равен null, будет использоваться текущее время по умолчанию.

Ошибки

При ошибке парсинга аргумента бросает исключение MongoDB\Driver\Exception\InvalidArgumentException.

Список изменений

Версия Описание

PECL mongodb 1.2.0

Версия	Описание
PECL mongodb 1.2.0	Аргумент `milliseconds` является необязательным и по умолчанию равен `null` (т.е. текущее время). Аргумент также принимает DateTimeInterface, который может использоваться для получения количества миллисекунд с начала эпохи Unix. Ранее принимался только тип int, float или string.

Аргумент milliseconds является необязательным и по умолчанию равен null (т.е. текущее время). Аргумент также принимает DateTimeInterface, который может использоваться для получения количества миллисекунд с начала эпохи Unix. Ранее принимался только тип int, float или string.

Примеры

Пример #1 Пример использования 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));

?>

Результатом выполнения данного примера будет что-то подобное:

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

Смотрите также

» Типы BSON: Date