DateInterval
在线手册:中文  英文

DateInterval::format

(PHP 5 >= 5.3.0)

DateInterval::formatFormats the interval

说明

public string DateInterval::format ( string $format )

Formats the interval.

参数

format

The following characters are recognized in the format parameter string. Each format character must be prefixed by a percent sign (%).
format character Description Example values
% Literal % %
Y Years, numeric, at least 2 digits with leading 0 01, 03
y Years, numeric 1, 3
M Months, numeric, at least 2 digits with leading 0 01, 03, 12
m Months, numeric 1, 3, 12
D Days, numeric, at least 2 digits with leading 0 01, 03, 31
d Days, numeric 1, 3, 31
a Total number of days as a result of a DateTime::diff() or (unknown) otherwise 4, 18, 8123
H Hours, numeric, at least 2 digits with leading 0 01, 03, 23
h Hours, numeric 1, 3, 23
I Minutes, numeric, at least 2 digits with leading 0 01, 03, 59
i Minutes, numeric 1, 3, 59
S Seconds, numeric, at least 2 digits with leading 0 01, 03, 57
s Seconds, numeric 1, 3, 57
R Sign "-" when negative, "+" when positive -, +
r Sign "-" when negative, empty when positive -,

返回值

Returns the formatted interval.

注释

Note:

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".

范例

Example #1 DateInterval example

<?php

$interval 
= new DateInterval('P2Y4DT6H8M');
echo 
$interval->format('%d days');

?>

以上例程会输出:

4 days

Example #2 DateInterval and carry over points

<?php

$interval 
= new DateInterval('P32D');
echo 
$interval->format('%d days');

?>

以上例程会输出:

32 days

Example #3 DateInterval and DateTime::diff() with the %a and %d modifiers

<?php

$january 
= new DateTime('2010-01-01');
$february = new DateTime('2010-02-01');
$interval $february->diff($january);

// %a will output the total number of days.
echo $interval->format('%a total days')."\n";

// While %d will only output the number of days not already covered by the
// month.
echo $interval->format('%m month, %d days');

?>

以上例程会输出:

31 total days
1 month, 0 days


DateInterval
在线手册:中文  英文

用户评论:

beowolve at gmail dot com (2013-07-03 10:13:56)

German Version of formatDateDiff:
function formatDateDiff($start, $end=null) {
if(!($start instanceof DateTime)) {
$start = new DateTime($start);
}
if($end === null) {
$end = new DateTime();
}
if(!($end instanceof DateTime)) {
$end = new DateTime($start);
}
$interval = $end->diff($start);
$doPlural = function($nb,$str){
if ($nb > 1) {
switch ($str) {
case 'Jahr':
case 'Monat':
case 'Tag':
return $str.'e';
case 'Stunde':
case 'Minute':
case 'Sekunde':
return $str.'n';
}
} else
return $str;
}; // adds plurals
$format = array();
if($interval->y !== 0) {
$format[] = "%y ".$doPlural($interval->y, "Jahr");
}
if($interval->m !== 0) {
$format[] = "%m ".$doPlural($interval->m, "Monat");
}
if($interval->d !== 0) {
$format[] = "%d ".$doPlural($interval->d, "Tag");
}
if($interval->h !== 0) {
$format[] = "%h ".$doPlural($interval->h, "Stunde");
}
if($interval->i !== 0) {
$format[] = "%i ".$doPlural($interval->i, "Minute");
}
if($interval->s !== 0) {
$format[] = "%s ".$doPlural($interval->s, "Sekunde");
}

if(count($format)==0 || (count($format)==1 && $interval->s !== 0)) {
return "weniger als eine Minute";
}
// We use the two biggest parts
if(count($format) > 1) {
$format = array_shift($format).", ".array_shift($format);
} else {
$format = array_pop($format);
}
// Prepend 'since ' or whatever you like
return $interval->format($format);
}

balaclark at gmail dot com (2011-06-02 03:58:19)

Be aware that your default timezone can sometimes alter the result of a diff so that the returned months/days are incorrect.
There is a bug report at: http://bugs.php.net/bug.php?id=52480

pekka at gmx dot de (2011-02-13 03:20:49)

Note that `%a` is broken on Windows on VC6 builds. http://bugs.php.net/bug.php?id=51184

kuzb (2011-02-04 17:15:12)

Quick class to allow you to input a time in any unit, and have it recalculate in to different denominations (for example, seconds to hours, minutes and seconds):

<?php
    
class DateIntervalEnhanced extends DateInterval
    
{

      
/* Keep in mind that a year is seen in this class as 365 days, and a month is seen as 30 days.         
         It is not possible to calculate how many days are in a given year or month without a point of  
         reference in time.*/
      
public function to_seconds()
      {
        return (
$this->365 24 60 60) +
               (
$this->30 24 60 60) +
               (
$this->24 60 60) +
               (
$this->60 60) +
               (
$this->60) +
               
$this->s;
      }
      
      public function 
recalculate()
      {
        
$seconds $this->to_seconds();
        
$this->floor($seconds/60/60/24/365);
        
$seconds -= $this->31536000;
        
$this->floor($seconds/60/60/24/30);
        
$seconds -= $this->2592000;
        
$this->floor($seconds/60/60/24);
        
$seconds -= $this->86400;
        
$this->floor($seconds/60/60);
        
$seconds -= $this->3600;
        
$this->floor($seconds/60);
        
$seconds -= $this->60;
        
$this->$seconds;
      }
    }

    
// Example usage
    
$di = new DateIntervalEnhanced('PT3600S');
    
$di->recalculate();
    
// outputs 1:0:0 instead of 0:0:3600 now!
    
echo $di->format('%H:%i:%s');
?>

baptiste dot place at utopiaweb dot fr (2010-03-15 07:47:56)

With php 5.3, DateTime is sweet !
Here is one quick example :

<?php
/**
 * A sweet interval formatting, will use the two biggest interval parts.
 * On small intervals, you get minutes and seconds.
 * On big intervals, you get months and days.
 * Only the two biggest parts are used. 
 * 
 * @param DateTime $start
 * @param DateTime|null $end
 * @return string
 */
public function formatDateDiff($start$end=null) {
    if(!(
$start instanceof DateTime)) {
        
$start = new DateTime($start);
    }
    
    if(
$end === null) {
        
$end = new DateTime();
    }
    
    if(!(
$end instanceof DateTime)) {
        
$end = new DateTime($start);
    }
    
    
$interval $end->diff($start);
    
$doPlural = function($nb,$str){return $nb>1?$str.'s':$str;}; // adds plurals
    
    
$format = array();
    if(
$interval->!== 0) {
        
$format[] = "%y ".$doPlural($interval->y"year");
    }
    if(
$interval->!== 0) {
        
$format[] = "%m ".$doPlural($interval->m"month");
    }
    if(
$interval->!== 0) {
        
$format[] = "%d ".$doPlural($interval->d"day");
    }
    if(
$interval->!== 0) {
        
$format[] = "%h ".$doPlural($interval->h"hour");
    }
    if(
$interval->!== 0) {
        
$format[] = "%i ".$doPlural($interval->i"minute");
    }
    if(
$interval->!== 0) {
        if(!
count($format)) {
            return 
"less than a minute ago";
        } else {
            
$format[] = "%s ".$doPlural($interval->s"second");
        }
    }
    
    
// We use the two biggest parts
    
if(count($format) > 1) {
        
$format array_shift($format)." and ".array_shift($format);
    } else {
        
$format array_pop($format);
    }
    
    
// Prepend 'since ' or whatever you like
    
return $interval->format($format);
}
?>

易百教程