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

# 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open