PHP - Manual: DateInterval::format

2025-11-04

DatePeriod »

« DateInterval::createFromDateString

DateInterval::format

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

DateInterval::format — Formats the interval

说明

public DateInterval::format(string $format): string

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`
`F`	Microseconds, numeric, at least 6 digits with leading 0	`007701`, `052738`, `428291`
`f`	Microseconds, numeric	`7701`, `52738`, `428291`
`R`	Sign "`-`" when negative, "`+`" when positive	`-`, `+`
`r`	Sign "`-`" when negative, empty when positive	`-`,

返回值

Returns the formatted interval.

更新日志

版本	说明
7.2.12	The `F` and `f` format will now always be positive.
7.1.0	The `F` and `f` format characters were added.

示例

示例 #1 DateInterval example

<?php

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

?>

以上示例会输出：

4 days

示例 #2 DateInterval and carry over points

<?php

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

?>

以上示例会输出：

32 days

示例 #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

注释

注意:
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".

参见

DateTime::diff() - 返回两个 DateTime 之间的差值

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 1 note

down

online dot cloudmeetings dot marco at gmail dot com ¶

7 months ago

Pls note these important abbreviations; 

P: period
Y: years
M: months
D: days
T: time
H: hours
M: minutes
S: seconds

The above is from the ISO 8601 - an international standard that defines how to use, store, and transfer date, time, and duration information.

＋添加备注

官方地址：https://www.php.net/manual/en/dateinterval.format.php

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

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

php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象常用的php ADODB使用方法集锦利用php soap实现web service ADOConnection 公用函数 adodb连接mysql多个数据库的问题 Composer的Packagist资源 php 将字符串中的连续多个空格转换为一个空格 php xml formatOuput无效的解决办法 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 mysql面试题

略微加速

PHP官方手册 - 互联网笔记

DateInterval::format

说明

参数

返回值

更新日志

示例

注释

参见

发现了问题？

用户贡献的备注 1 note