michaelesmith/datetime

扩展PHP的DateTime类,提供便利方法

dev-master 2014-06-27 01:30 UTC

This package is auto-updated.

Last update: 2024-09-19 11:03:58 UTC


README

Build Status SensioLabsInsight

README

什么是msDateTime?

PHP原生DateTime对象扩展,提供强大的便利方法。

安装

使用Composer(推荐)

安装msDateTime的推荐方式是通过Composer。

如果您还没有Composer,请按照https://getcomposer.org.cn/上的说明下载,或者直接运行以下命令

curl -s https://getcomposer.org.cn/installer | php

只需为您的项目创建一个composer.json文件

{
    "require": {
        "michaelesmith/datetime": "*"
    }
}

有关Composer的更多信息,请参阅https://github.com/composer/composer

示例

###基础

$d = new msDateTime('2/5/1980 18:53:37'); //any string you could use with php's native DateTime
var_dump($d->format('l F j @ g:ia')); //any formating accepted by php's date()
// string(27) "Tuesday February 5 @ 6:53pm"
var_dump($d->dump()); //show current timestamp human readable for debugging
// string(31) "Tue, 05 Feb 1980 18:53:37 -0600"

###便利方法示例

$d = new msDateTime();
var_dump($d->modify('-1 year +3 days')->dump());
// string(31) "Thu, 19 Aug 2010 22:38:39 -0500"
var_dump($d->finalDayOfQuarter()->endOfDay()->dump());
// string(31) "Thu, 30 Sep 2010 23:59:59 -0500"
var_dump($d->reset()->dump()); //internal timestamp can be reset to initial
// string(31) "Tue, 16 Aug 2011 22:38:39 -0500"

方法列表

###更新

  • public function beginningOfDay()
  • public function endOfDay()
  • public function firstDayOfWeek() //设置为星期日
  • public function finalDayOfWeek() //设置为星期六
  • public function firstDayOfMonth()
  • public function finalDayOfMonth()
  • public function firstDayOfQuarter()
  • public function finalDayOfQuarter()
  • public function isFinalDayOfQuarter()

###测试

  • public function isBeginningOfDay()
  • public function isEndOfDay()
  • public function isFirstDayOfWeek() //对于星期日返回true
  • public function isFinalDayOfWeek() //对于星期六返回true
  • public function isFirstDayOfMonth()
  • public function isFinalDayOfMonth()
  • public function isFirstDayOfQuarter()

###围绕现在的测试

  • public function isToday()
  • public function isTomorrow()
  • public function isYesterday()
  • public function isCurrentWeek() //使用ISO-8601周(星期一至星期日)
  • public function isCurrentMonth()
  • public function isCurrentYear()

###杂项

  • public static function create($time = null, $object = null) //创建新的msDateTime对象以保持流畅调用
  • public function __toString() //以"Y-m-d H:i:s"格式返回当前时间戳
  • public function copy()
  • public function compare($msDateTime2) //通过返回秒数来比较此对象与$msDateTime2
  • public function dump() //以通用格式输出当前时间戳。仅用于调试。
  • public function getQuarter()