dateinterval.createfromdatestring(3) [php man page]

DATEINTERVAL.CREATEFROMDATESTRING(3)					 1				      DATEINTERVAL.CREATEFROMDATESTRING(3)

DateInterval::createFromDateString - Sets up a DateInterval from the relative parts of the string

SYNOPSIS

       publicstatic DateInterval DateInterval::createFromDateString (string  $time)

DESCRIPTION

	Uses the normal date parsers and sets up a DateInterval from the relative parts of the parsed string.

PARAMETERS

	      o $time
		-  A  date with relative parts. Specifically, the relative formats supported by the parser used for strtotime(3) and DateTime will
		be used to construct the DateInterval.

EXAMPLES

       Example #1

	      Parsing valid date intervals

	      <?php
	      // Each set of intervals is equal.
	      $i = new DateInterval('P1D');
	      $i = DateInterval::createFromDateString('1 day');

	      $i = new DateInterval('P2W');
	      $i = DateInterval::createFromDateString('2 weeks');

	      $i = new DateInterval('P3M');
	      $i = DateInterval::createFromDateString('3 months');

	      $i = new DateInterval('P4Y');
	      $i = DateInterval::createFromDateString('4 years');

	      $i = new DateInterval('P1Y1D');
	      $i = DateInterval::createFromDateString('1 year + 1 day');

	      $i = new DateInterval('P1DT12H');
	      $i = DateInterval::createFromDateString('1 day + 12 hours');

	      $i = new DateInterval('PT3600S');
	      $i = DateInterval::createFromDateString('3600 seconds');
	      ?>

RETURN VALUES

	Returns a new DateInterval instance.

PHP Documentation Group 										      DATEINTERVAL.CREATEFROMDATESTRING(3)

DATEINTERVAL(3) 							 1							   DATEINTERVAL(3)

The DateInterval class

INTRODUCTION

	Represents a date interval.

	A  date  interval  stores  either  a fixed amount of time (in years, months, days, hours etc) or a relative time string in the format that
       DateTime's constructor supports.

CLASS SYNOPSIS

       DateInterval

       DateInterval

       Properties

       o public integer$y

       o public integer$m

       o public integer$d

       o public integer$h

       o public integer$i

       o public integer$s

       o public integer$invert

       o public mixed$days

       Methods

       o public DateInterval::__construct (string  $interval_spec)

       o publicstatic DateInterval DateInterval::createFromDateString (string  $time)

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

PROPERTIES

	      o $y
		- Number of years.

	      o $m
		- Number of months.

	      o $d
		- Number of days.

	      o $h
		- Number of hours.

	      o $i
		- Number of minutes.

	      o $s
		- Number of seconds.

	      o $invert
		- Is 1 if the interval represents a negative time period and 0 otherwise. See DateInterval::format.

	      o $days
		- If the DateInterval object was created by DateTime.diff(3), then this is the total number of days  between  the  start  and  end
		dates.	Otherwise, $days will be FALSE.  Before PHP 5.4.20/5.5.4 instead of FALSE you will receive -99999 upon accessing the prop-
		erty.

PHP Documentation Group 													   DATEINTERVAL(3)