# MongoDB\BSON\ObjectId::getTimestamp

(mongodb >=1.2.0)

MongoDB\BSON\ObjectId::getTimestamp — Returns the timestamp component of this ObjectId

### 说明

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

The timestamp component of an ObjectId is its most significant 32 bits, which denotes the number of seconds since the Unix epoch. This value is read as an unsigned 32-bit integer with big-endian byte order.

> 注意: Because PHP's integer type is signed, some values returned by this method may appear as negative integers on 32-bit platforms. The `"%u"` formatter of sprintf() may be used to obtain a string representation of the unsigned decimal value.

### 参数

此函数没有参数。

### 返回值

Returns the timestamp component of this ObjectId.

### 错误／异常

- Throws MongoDB\Driver\Exception\InvalidArgumentException on argument parsing errors.

### 示例

示例 #1 MongoDB\BSON\ObjectId::getTimestamp() example

`<?php
var_dump((new MongoDB\BSON\ObjectId())->getTimestamp());
var_dump((new MongoDB\BSON\ObjectId('0000002a0000000000000000'))->getTimestamp());
?>`

以上示例的输出类似于：

    integer(1484854719)
    integer(42)

### 参见

- » ObjectId Reference
- » BSON Types: ObjectId

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