Возвращает метку времени ObjectId

# MongoDB\BSON\ObjectId::getTimestamp

(mongodb >=1.2.0)

MongoDB\BSON\ObjectId::getTimestamp — Возвращает метку времени ObjectId

### Описание

final public function MongoDB\BSON\ObjectId::getTimestamp(): int

Компонент метки времени в ObjectId - это его наиболее значимые 32 бита, которые обозначают количество секунд с начала эпохи Unix. Это значение читается, как 32-разрядное целое число без знака с порядком байтов в старшем порядке.

> Замечание: Поскольку целочисленный тип в PHP — знаковый, некоторые значения, которые получают этим методом, на 32-битных платформах могут превратиться в отрицательные целые числа. Чтобы получить строковое представление беззнакового целого, пользуются шаблоном форматирования "%u" функции sprintf().

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

Сигнатура функции не содержит параметров.

### Возвращаемые значения

Возвращает метку времени ObjectId.

### Ошибки

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

### Примеры

Пример #1 Пример использования MongoDB\BSON\ObjectId::getTimestamp()

    <?php

    var_dump((new MongoDB\BSON\ObjectId())->getTimestamp());

    var_dump((new MongoDB\BSON\ObjectId('0000002a0000000000000000'))->getTimestamp());

    ?>

Вывод приведённого примера будет похож на:

    integer(1484854719)
    integer(42)

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

- » Справка по ObjectId
- » Типы BSON: ObjectId

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