PHP date_interval_create_from_date_string() 函数

定义和用法

date_interval_create_from_date_string() 函数是 DateInterval::createFromDateString 的别名。它接受一个指定区间的字符串，并返回一个 DateInterval 对象。

语法

date_interval_create_from_date_string($time)

参数

返回值

PHP date_interval_create_from_date_string() 返回一个表示给定区间值的 DateInterval 对象。

PHP 版本

此函数首次出现在 PHP 5.3 版本中，并适用于所有后续版本。

示例

以下示例演示了 date_interval_create_from_date_string() 函数的用法：

<?php
   $time = "3year + 3months + 26 day + 12 hours+ 30 minutes +23 seconds";
   $interval = date_interval_create_from_date_string($time);
   print_r($interval);
?>

这将产生以下结果：

DateInterval Object
(
    [y] => 3
    [m] => 3
    [d] => 26
    [h] => 12
    [i] => 30
    [s] => 23
    [f] => 0
    [weekday] => 0
    [weekday_behavior] => 0
    [first_last_day_of] => 0
    [invert] => 0
    [days] =>
    [special_type] => 0
    [special_amount] => 0
    [have_weekday_relative] => 0
    [have_special_relative] => 0
)

在此函数中，您不能使用类似“P12M”的 ISO8601 字符串来解析此类区间，您需要使用 DateInterval 构造函数。

示例

在以下示例中，我们使用 ISO8601 字符串表示法来创建一个区间：

<?php
  $time1 = new DateInterval('P25DP8MP9Y');
   print_r($time1);
   $time2 = new DateInterval('PT10H');
   print_r($time2);
?>

这将产生以下结果：

DateInterval Object
(
    [y] => 9
    [m] => 8
    [d] => 25
    [h] => 0
    [i] => 0
    [s] => 0
    [f] => 0
    [weekday] => 0
    [weekday_behavior] => 0
    [first_last_day_of] => 0
    [invert] => 0
    [days] =>
    [special_type] => 0
    [special_amount] => 0
    [have_weekday_relative] => 0
    [have_special_relative] => 0
)
DateInterval Object
(
    [y] => 0
    [m] => 0
    [d] => 0
    [h] => 10
    [i] => 0
    [s] => 0
    [f] => 0
    [weekday] => 0
    [weekday_behavior] => 0
    [first_last_day_of] => 0
    [invert] => 0
    [days] =>
    [special_type] => 0
    [special_amount] => 0
    [have_weekday_relative] => 0
    [have_special_relative] => 0
)

示例

以下示例将区间添加到当前日期并打印结果。这里我们使用 date_interval_create_from_date_string 函数来计算区间：

<?php
   $date = date_create(); 
   $str = "12year 3months 14days";
   $interval = date_interval_create_from_date_string($str);

   $res1 = date_add($date, $interval); 
   print("Date after ".$str);
   print(": ".date_format($res1, 'Y-m-d'));
?>

这将产生以下结果：

Date after 12year 3months 14days: 2032-08-28

示例

以下示例使用各种 ISO8601 字符串及其相应的普通字符串创建日期区间：

<?php
   print(new DateInterval('P12D')."\n");
   print(DateInterval::createFromDateString('12 day')."\n");

   print(new DateInterval('P7')."\n");
   print(DateInterval::createFromDateString('7 months')."\n");

   print(new DateInterval('P12Y')."\n");
   print(DateInterval::createFromDateString('12 years')."\n");

   print(new DateInterval('PT9H')."\n");
   print(DateInterval::createFromDateString('9 hours')."\n");

   print(new DateInterval('PT19i')."\n");
   print(DateInterval::createFromDateString('19 minutes')."\n");

   print(new DateInterval('PT45S')."\n");
   print(DateInterval::createFromDateString('45 seconds')."\n");
?>