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 __construct(int|float|string|DateTimeInterface|null $milliseconds = null)

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	实现 Stringable 用于 PHP 8.0+
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

改进此页面

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加笔记

用户贡献笔记 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 ¶

7 年前

如果您需要微秒精度，请谨慎使用 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"

注意：从 PHP 7.1.0 RC4 开始，修复了有关 DateTimeInterface 类微秒格式的大量错误。上面的代码来自 PHP 7.1.0 RC5 和 mongodb 1.2.0alpha3。1.2.0 版本的扩展添加了在不传递整数毫秒的情况下实例化此类功能。

上

下

mike at brenden dot com ¶