MongoDB\BSON\UTCDateTime 類別

(mongodb >=1.0.0)

簡介

表示 » BSON 日期。此值是一個 64 位元整數，表示自 Unix 紀元 (1970 年 1 月 1 日) 以來的毫秒數。負值表示 1970 年之前的日期。

類別概要

final class MongoDB\BSON\UTCDateTime implements MongoDB\BSON\UTCDateTimeInterface, MongoDB\BSON\Type, Serializable, JsonSerializable, Stringable {

/* 方法 */

final public jsonSerialize(): mixed

final public serialize(): string

final public toDateTime(): DateTime

final public toDateTimeImmutable(): DateTimeImmutable

final public __toString(): string

final public unserialize(string $data): void

}

更新日誌

版本	說明
PECL mongodb 1.12.0	在 PHP 8.0+ 中實作 Stringable 介面。
PECL mongodb 1.3.0	實作 MongoDB\BSON\UTCDateTimeInterface 介面。
PECL mongodb 1.2.0	實作 Serializable 和 JsonSerializable 介面。

MongoDB\BSON\UTCDateTime::__construct — 建構新的 UTCDateTime
MongoDB\BSON\UTCDateTime::jsonSerialize — 返回可轉換為 JSON 的表示法
MongoDB\BSON\UTCDateTime::serialize — 序列化 UTCDateTime
MongoDB\BSON\UTCDateTime::toDateTime — 返回此 UTCDateTime 的 DateTime 表示法
MongoDB\BSON\UTCDateTime::toDateTimeImmutable — 返回此 UTCDateTime 的 DateTimeImmutable 表示法
MongoDB\BSON\UTCDateTime::__toString — 返回此 UTCDateTime 的字串表示法
MongoDB\BSON\UTCDateTime::unserialize — 反序列化 UTCDateTime

發現問題了嗎？

了解如何改進此頁面 • 提交 Pull Request • 回報錯誤

＋新增註記

使用者貢獻的註記 3 則註記

向上

向下

Stephen ¶

6 年前

使用 MongoDB\BSON\UTCDateTime 進行查詢時，請確保 strtotime 的實例使用毫秒作為建構函式的參數。

$start = new MongoDB\BSON\UTCDateTime(strtotime("midnight") * 1000);
$filter = ['date' => ['$gte' => $start]];
$options = ['sort' => ['date' => -1]];
$query = new MongoDB\Driver\Query($filter, $options);

向上

向下

mark at DONTSPAM dot moderndeveloperllc dot com ¶

8 年前

如果您需要微秒精度，使用 UTCDateTime 時要小心，因為這個類別只儲存到 _毫秒_。如果您想要完整的精度，您需要將日期以字串形式儲存在 MongoDB 中。將 DateTime 轉換為浮點數也可能會降低精度。

一個簡單的查看差異的方法是：

程式碼
var_dump(
(new DateTime)->format('U.u'),
(float) (new DateTime)->format('U.u'),
(new MongoDB\BSON\UTCDateTime())->toDateTime()->format('U.u')
);

輸出
string(17) "1477534060.918415"
double(1477534060.9185)
string(17) "1477534060.918000"

注意：許多關於 DateTimeInterface 類別的微秒格式化錯誤已在 PHP 7.1.0 RC4 中修復。以上程式碼來自 PHP 7.1.0 RC5 和 mongodb 1.2.0alpha3。1.2.0 版本的擴充程式增加了在不傳入整數毫秒的情況下實例化此類別的功能。

向上

向下

mike at brenden dot com ¶