Code Coverage
	Classes and Traits			Functions and Methods				Lines
Total		n/a	0 / 0		n/a	0 / 0	CRAP		n/a	0 / 0

1	<?php
2
3	namespace Popy\Calendar;
4
5	use DateTimeZone;
6	use DateTimeInterface;
7	use Popy\Calendar\ValueObject\DateRepresentationInterface;
8
9	/**
10	* A Parser is responsible to parse an input string, according to a format, in
11	* order to build a Date matching the input representation as close as possible.
12	*
13	* If the Parser is related to a Formatter, its format SHOULD be the same as the
14	* related Formatter.
15	*
16	* The Parser MAY support some name localization.
17	*/
18	interface ParserInterface
19	{
20	/**
21	* Parses a time string according to a specified format, then returns
22	* DateTimeInterface or null if not able to match.
23	*
24	* @param string            $input  Input date string.
25	* @param string            $format Date format
26	* @param DateTimeZone|null $timezone
27	*
28	* @return DateTimeInterface|null
29	*/
30	public function parse($input, $format, DateTimeZone $timezone = null);
31
32	/**
33	* Parses a time string according to a specified format, then returns
34	* DateRepresentationInterface or null if not able to match.
35	*
36	* @param string            $input  Input date string.
37	* @param string            $format Date format
38	* @param DateTimeZone|null $timezone
39	*
40	* @return DateRepresentationInterface|null
41	*/
42	public function parseToDateRepresentation($input, $format, DateTimeZone $timezone = null);
43	}