MongoDB\BSON\UTCDateTime::__construct

(mongodb >=1.0.0)

MongoDB\BSON\UTCDateTime::__construct — Создаёт новый объект 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

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 3 notes

down

0xff00ff at gmail dot com ¶

10 years ago

$utcdatetime = new MongoDB\BSON\UTCDateTime($unixtimestamp * 1000);

down

jesperbendtsen83 at gmail dot com ¶

10 years ago

For me to get it work with php 5.6 on an iis 7.5, it had to be a string

$utcdatetime = new MongoDB\BSON\UTCDateTime('1416445411987');

down

-3

jesperbendtsen83 at gmail dot com ¶

10 years ago

The problem with integer => string is only on 32 bit systems

＋Добавить