cherrypick / hammertime
Some extensions to Carbon (a DateTime class)
Installs: 22 532
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 3
Forks: 2
Open Issues: 0
Requires
- nesbot/carbon: ~1.24
This package is not auto-updated.
Last update: 2024-10-26 16:49:08 UTC
README
This date library extends Carbon with some more sophisticated date calculations and getters / setters for all date parts.
Installation
Install using composer:
composer require cherrypick/hammertime
Features
More sophisticated date calculations
The date calculations with HammerTime are closer to real world problems. When you are at the end of a month and add another month, it doesn't leap into the beginning of the month afterwards.
$date = HammerTime::createFromDate(2014, 5, 31); $date->addMonths(1); // 2014-06-30 (with default PHP DateTime (and Carbon) it would be 2014-07-01) $date = HammerTime::createFromDate(2012, 2, 29); $date->addYear(1); // 2013-02-28 (with default PHP DateTime (and Carbon) it would be 2013-03-01)
Similar, it applies to the diff of months. You can find more information and examples here.
$date1 = HammerTime::createFromDate(2014, 2, 1); $date2 = HammerTime::createFromDate(2014, 3, 1); $date1->diffInMonths($date2); // 1 (with default PHP DateTime (and Carbon) it would be 0)
Date Comparisons
This library provides some more clear names for date comparisons.
$date1->isSameDate($date2); $date1->isBefore($date2); $date1->isBeforeOrEqual($date2); $date1->isAfter($date2); $date1->isAfterOrEqual($date2);
Getters and Setters
This library provides getters and setters for all available date information:
$date = HammerTime::createFromDate(2014, 11, 30, 12, 42, 42); $date->getDay(); // 30 $date->getMonth(); // 11 $date->getYear(); // 2014 $date->getHour(); // 12 $date->getMinute(); // 42 $date->getSecond(); // 42 // and many more... // the same applies to setters. $date->setDay(20); // 2014-11-20 // etc..
There are Getters and Setters for every availble property.