activecollab/datevalue

Simple extension to Carbon that makes distinction between date and date-time objects

2.1.0 2022-08-10 07:26 UTC

This package is auto-updated.

Last update: 2024-11-10 12:07:44 UTC


README

Build Status

Simple extension to Carbon that makes distinction between date and date-time objects. In order to create a date object, write:

<?php

namespace MyApp;

use ActiveCollab\DateValue\DateValue;

$date = new DateValue('last day of April 2017');
print $date->format('Y-m-d') . "\n";

In order to create a date and time object, create a DateTimeValue instance:

<?php

namespace MyApp;

use ActiveCollab\DateValue\DateTimeValue;

$date_time = new DateTimeValue('last day of April 2017');
print $date_time->format('Y-m-d H:i:s') . "\n";

Since both DateValue, and DateTimeValue classes extend Carbon, you can also use all Carbon methods in your code:

<?php

namespace MyApp;

use ActiveCollab\DateValue\DateTimeValue;

$date_time = (new DateTimeValue('last day of April 2017'))->endOfDay();
print $date_time->format('Y-m-d H:i:s') . "\n";

To specify a date range, use DateRange class. Ranges can be easily iterated:

<?php

namespace MyApp;

use ActiveCollab\DateValue\DateRange;
use ActiveCollab\DateValue\DateValue;
use ActiveCollab\DateValue\DateValueInterface;

$first_day = new DateValue('first day of April 2017');
$last_day = new DateValue('last day of April 2017');

$date_range = new DateRange($first_day, $last_day);

/** @var DateValueInterface $day */
foreach ($date_range as $day) {
    $this->assertInstanceOf(DateValueInterface::class, $day);
    print $day->format('Y-m-d') . "\n"; // Prints all days from 2017-04-01 to 2017-04-30.
}

There are three helper date range classes:

<?php

namespace MyApp;

use ActiveCollab\DateValue\DateRange\MonthDateRange;
use ActiveCollab\DateValue\DateRange\QuarterDateRange;
use ActiveCollab\DateValue\DateRange\YearDateRange;

new MonthDateRange(2017, 4); // April 2017.
new QuarterDateRange(2017, 2); // Q2 2017.
new YearDateRange(2017); // The whole 2017.

These ranges automatically calculate start and end dates, and they can be iterated, just like custom date ranges.

Version 2

Goals of second iteration of this package are:

  • Make the package require PHP 7.1, and use strict types in all files,
  • Make the library 100% covered with tests,
  • Add support for custom date ranges, as well as year, quarter, month, and day ranges,
  • Add support for easy looping in date ranges.