Создаёт новый объект UTCDateTime

Описание

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

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

milliseconds (int|MongoDB\BSON\Int64|DateTimeInterface|null): Количество миллисекунд с начала Unix-эпохи — 1 января 1970 г. Отрицательные значения представляют даты до 1970 года. Параметр принимает значения в виде 64-разрядного целого числа (int). В целях совместимости с 32-разрядными системами параметр принимает также объекты MongoDB\BSON\Int64. Метод возьмёт количество миллисекунд с начала эпохи Unix из объекта DateTimeInterface, если его передали в аргументе. Метод возьмёт по умолчанию текущее время, если значение параметра будет равняться null.

Ошибки

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

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

Версия	Описание
PECL-модуль mongodb 2.0.0	Параметр `milliseconds` больше не принимает аргументы с типом string или float.
PECL-модуль mongodb 1.20.0	В целях совместимости с 32-разрядными платформами параметр `milliseconds` теперь принимает объекты MongoDB\BSON\Int64. Передача строк (string) и чисел с плавающей точкой (float) устарела.
PECL-модуль mongodb 1.2.0	Аргумент `milliseconds` необязателен и по умолчанию равен `null` — текущему времени. Аргумент принимает также объекты DateTimeInterface, из которого метод возьмёт количество миллисекунд с начала эпохи Unix. Раньше метод принимал только значения типов int, float или string.

Примеры

Пример #1 Пример создания нового объекта UTCDateTime методом 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