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	实现 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 ¶

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"

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

上移

下移

mike at brenden dot com ¶