PHP - Manual: MongoDate

2024-12-24

The MongoDate class

(PECL mongo >=0.8.1)

Warning

This extension that defines this class is deprecated. Instead, the MongoDB extension should be used. Alternatives to this class include:

MongoDB\BSON\UTCDateTime

简介

Represent date objects for the database. This class should be used to save dates to the database and to query for dates. For example:

Example #1 Storing dates with MongoDate


<?php

// save a date to the database
$collection->save(array("ts" => new MongoDate()));

$start = new MongoDate(strtotime("2010-01-15 00:00:00"));
$end = new MongoDate(strtotime("2010-01-30 00:00:00"));

// find dates between 1/15/2010 and 1/30/2010
$collection->find(array("ts" => array('$gt' => $start, '$lte' => $end)));

?>

MongoDB stores dates as milliseconds past the epoch. This means that dates do not contain timezone information. Timezones must be stored in a separate field if needed. Second, this means that any precision beyond milliseconds will be lost when the document is sent to/from the database.

类摘要

MongoDate {

/* Fields */

public int $sec ;

public int $usec ;

/* 方法 */

public __construct ([ int $sec = time() [, int $usec = 0 ]] )

public toDateTime ( void ) : DateTime

public __toString ( void ) : string

}

MongoDate::__construct — 创建一个新的日期。
MongoDate::toDateTime — Returns a DateTime object representing this date
MongoDate::__toString — 返回该日期的字符串形式的表达

add a note

User Contributed Notes 4 notes

down

jhonnydcano at yahoo dot com ¶

9 years ago


For showing a human readable MongoDate, you can use something like this:



<?php

date('Y-M-d h:i:s', $yourDate->sec);

?>

down

Philipp ¶

2 years ago


This extension is deprecated, but some people still have to use it.

Please, note that properties (sec, usec) are read-only.

You have to do something like this:

<?php

$d = new \MongoDate();

echo "\n" . $d->toDateTime()->format(\DateTime::ISO8601);

// move to future for 125 seconds
$d = new \MongoDate($d->sec + 125, $d->usec);

echo "\n" . $d->toDateTime()->format(\DateTime::ISO8601);

?>

down

-1

mike at brenden dot com ¶

1 year ago


MichaelBrenden --

How do the two Mongo drivers determine if they can translate something into the ISODate format?

Does mongo.so require a class type of MongoDate, or does it determine by data returned by __toString() (i.e., "0.12345678 1234567890")?

Does mongodb.so require a class type of \MongoDB\BSON\UTCDateTime, or does it determine by data returned by __toString() (i.e., "1234567890123")?

jmikola

>> the ISODate format?

For the record, ISODate is just a helper function in the mongo shell. The actual BSON type is 0x09 in the BSON spec and is best referred to as "UTC date time".
[url]https://docs.mongodb.com/manual/core/shell-types/#return-date[/url]
[url]http://bsonspec.org/spec.html[/url]

 >> Does mongodb.so require a class type of \MongoDB\BSON\UTCDateTime, or does it determine by data returned by __toString() (i.e., "1234567890123")?

The driver requires a MongoDB\BSON\UTCDateTime object in order to encode a BSON date type. The relevant instanceof check during BSON encoding is here if you care to see it. The __toString() function exists purely as a convenience for userland applications. The driver does not use it outside of tests.
[url]https://github.com/mongodb/mongo-php-driver/blob/1.3.4/src/bson-encode.c#L215[/url]

The legacy mongo.so driver is similar in that it requires a MongoDate object in order to encode a BSON date type (relevant code is here).
[url]https://github.com/mongodb/mongo-php-driver-legacy/blob/1.6.16/bson.c#L273[/url]

down

-44

richard at securebucket dot com ¶

7 years ago


I wanted a way to check the age of a record.  This code will calculate the time between the creation date of the record, and return the seconds.  I use it for caching pages similar to the max-age header in a browser.  If the record is older, than my limit it deletes itself.



<?php

function microtime_diff( $start, $end=NULL ) { 

        if( !$end ) { 

            $end= microtime(); 

        } 

        list($start_usec, $start_sec) = explode(" ", $start); 

        list($end_usec, $end_sec) = explode(" ", $end); 

        $diff_sec= intval($end_sec) - intval($start_sec); 

        $diff_usec= floatval($end_usec) - floatval($start_usec); 

        return floatval( $diff_sec ) + $diff_usec; 

} 



microtime_diff($cache['stamp']->sec);

?>

add a note

官方地址：https://www.php.net/manual/en/class.mongodate.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP 8.1 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 mysql面试题 PHP json解析（json_decode）页面工具 php中几种注释规范 PHPMailer设置utf8 PHPMailer字符集CharSet PHP5 扩展SOAP 调用 webservice PHP获取指定函数定义在哪个文件中及行号 PHP mkdir()写出来的权限与mode值不符合 php扩展开发 [原创]诡异的php-fpm超时问题

略微加速

PHP官方手册 - 互联网笔记

The MongoDate class

简介

类摘要

Table of Contents

User Contributed Notes 4 notes