English | 简体中文 | 繁體中文
查询

date_interval_create_from_date_string()函数—用法及示例

「 创建一个日期间隔对象,通过解析字符串表示的日期间隔 」


函数名称:date_interval_create_from_date_string() 函数描述:该函数用于创建一个日期间隔对象,通过解析字符串表示的日期间隔。

适用版本:>= PHP 5.3.0

用法: date_interval_create_from_date_string(string $time) : DateInterval|false

参数:

  • $time:表示日期间隔的字符串,必须遵循以下格式:PnYnMnDTnHnMnS(其中n表示数字,nY代表年份,nM代表月份,nD代表天数,nH代表小时数,nM代表分钟数,nS代表秒数)。

返回值:

  • 如果成功创建了日期间隔对象,则返回DateInterval对象。
  • 如果传递的时间字符串无效,则返回false。

示例:

// 创建一个表示30分钟的日期间隔对象
$interval = date_interval_create_from_date_string('30 minutes');

// 输出间隔的小时数和分钟数
echo $interval->format('%h hours, %i minutes');  // 输出: 0 hours, 30 minutes

// 创建一个表示1天5小时的日期间隔对象
$interval = date_interval_create_from_date_string('1 day 5 hours');

// 输出间隔的天数和小时数
echo $interval->format('%d days, %h hours');  // 输出: 1 days, 5 hours

// 创建一个无效的日期间隔对象
$interval = date_interval_create_from_date_string('invalid'); 

if ($interval === false) {
    echo '无效的时间字符串';
}

注意事项:

  • 日期间隔对象用于表示一个时间段,可以用于做日期运算和操作。
  • 时间字符串必须遵循ISO 8601标准,否则将被视为无效。
  • 时间字符串的每个部分都是可选的,如果没有提供则默认为0。
  • 日期间隔对象的格式化可以使用DateInterval的format()方法进行自定义输出。
  • 如果传递的时间字符串无效,函数将返回false,因此建议使用条件语句来检查返回值是否为false。
补充纠错
上一个函数: date_get_last_errors()函数
下一个函数: date_interval_format()函数
热门PHP函数
分享链接