[edit] Last updated: Fri, 25 May 2012

DateInterval クラス

(PHP 5 >= 5.3.0)

導入

日付の間隔をあらわします。格納方式は、固定値 (年、月、日、時など) あるいは相対時刻 (DateTime のコンストラクタがサポートしている書式) となります。

クラス概要

DateInterval {

/* プロパティ */

public integer $y ;

public integer $m ;

public integer $d ;

public integer $h ;

public integer $i ;

public integer $s ;

public integer $invert ;

public mixed $days ;

/* メソッド */

public __construct ( string $interval_spec )

public static DateInterval createFromDateString ( string $time )

public string format ( string $format )

}

プロパティ

y: 年。
m: 月。
d: 日。
h: 時間。
i: 分。
s: 秒。
invert: 間隔が反転している場合は 1、そうでない場合は 0。 DateInterval::format() を参照ください。
days: DateTime::diff() の計算における、開始日と終了日の間の日数。それ以外の場合は days は FALSE となります。


If you want to convert a Timespan given in Seconds into an DateInterval Object you could dot the following:



<?php



$dv = new DateInterval('PT'.$timespan.'S');

?>



but wenn you look at the object, only the $dv->s property is set. 



As stated in the documentation to DateInterval::format



The DateInterval::format() method does not recalculate carry over points in time strings nor in date segments. This is expected because it is not possible to overflow values like "32 days" which could be interpreted as anything from "1 month and 4 days" to "1 month and 1 day". 



If you still want to calculate the seconds into hours / days / years, etc do the following:



<?php



$d1 = new DateTime();

$d2 = new DateTime();

$d2->add(new DateInterval('PT'.$timespan.'S'));

      

$iv = $d2->diff($d1);



?>



$iv is an DateInterval set with days, years, hours, seconds, etc ...

Anonymous 18-Feb-2011 01:42


You cannot use the ++ operator on the DateInterval fields; it has no effect on the field value. To increase a field value, you have to do it the long way, for example $diff->h = $diff->h + 1; instead of $diff->h++; (observed in PHP 5.3.1).

jeff dot davies at yahoo dot com 14-Sep-2010 07:15


This class became available in PHP 5.3. It is not present in 5.2 or earlier releases. I found this out the hard way when you PHP scripts stopped working when I deployed them onto a Yahoo server. Yahoo has 5.2 while my machine hosts 5.3.

sebastien dot michea at manaty dot net 29-Aug-2010 10:25


It would be nice that when converting a DateInterval to a string, the interval specification used to construct the object is returned (like "P2W").

I need this to serialize a DateInterval object in order to store it in a postgres DB.

add a note

DateInterval クラス

導入

クラス概要

プロパティ

目次