Wallogit.com
2017 © Pedro Peláez
Calendar Interfaces, tools, and basic implementation
This repository holds interfaces defining a Calendar, whose purpose is to manipulate (format, parse) php dates, and a few utilities and very basic implementations., (*1)
Code Coverage, (*2)
composer require popy/calendar
format(new DateTime(), 'Y-m-d');
var_dump(
$calendar->parse('2000-01-01', 'Y-m-d')
);
?>
Output :, (*3)
2018-02-10
object(DateTimeImmutable)#2 (3) {
["date"]=>
string(26) "2000-01-01 21:28:31.000000"
["timezone_type"]=>
int(3)
["timezone"]=>
string(13) "Europe/Berlin"
}
A CalendarInterface basically reproduce the behaviour of DateTime::format and
DateTime::createFromFormat. the Popy\Calendar\Calendar\GregorianCalendar is only a decorator
around these methods, so, what's the point ?, (*4)
First, CalendarInterface, FormaterInterface and ParserInterface are implementable
interfaces, removing some responsibilities for classes handling dates. The PresetFormater and
PresetParser even co a step further by handling themselves the format to use, so the classes
having to deal with dates (parsing or displaying) do no longer have to deal with format or locale., (*5)
But this package containes also other components which can be used to compose a CalendarInterface
implementation, allowing to :, (*6)
The preset formater is a helper object taking any formater and a format as constructor parameter, allowing to be able to format a date without knowing which format is expected., (*7)
Inject it in any service dealing with date representation means they no longer have the responsibility to choose the format they are using (and not even the calendar). That's a way to have application-wide date format., (*8)
format(new DateTime()); ?>
Output :, (*9)
2018-02-10
The preset parser is a helper object taking any parse and a format as constructor parameter, allowing to be able to parse a date without knowing which format is expected., (*10)
Could be used, for instance, by a service hydrating data fetched from a webservice, without having to know which calendar/format is used., (*11)
parse('2017-05-01'));
?>
Output :, (*12)
object(DateTimeImmutable)#2 (3) {
["date"]=>
string(26) "2017-05-01 21:28:31.000000"
["timezone_type"]=>
int(3)
["timezone"]=>
string(13) "Europe/Berlin"
}
Calendar Interfaces, tools, and basic implementation
MIT
calendar date datetime
Calendar Interfaces, tools, and basic implementation
MIT
calendar date datetime
Calendar Interfaces, tools, and basic implementation