datrim/date-range

Date range utility

DateRange

DateRange is a simple package for creating and using a starting and ending date., _(*1)

Installation

Composer

From the command line, run:, _(*2)

composer require datrim/date-range

Usage

The Basics

With the package now installed, you may use the two classes like so:, _(*3)

Create date range for today (00:00 - 23:59)

use Datrim\DateRange\DateRange;

$today = DateRange::today();

Create date range for last week

use Datrim\DateRange\DateRange;

$today = DateRange::lastWeek();

Create date range for this week

use Datrim\DateRange\DateRange;

$today = DateRange::thisWeek();

Create date range for last month

use Datrim\DateRange\DateRange;

$today = DateRange::lastMonth();

Create date range for this month

use Datrim\DateRange\DateRange;

$today = DateRange::thisMonth();

Create date range for this year

use Datrim\DateRange\DateRange;

$year = DateRange::thisYear();

Create date range for a specified year

use Datrim\DateRange\DateRange;

$year = DateRange::year(2010);

Get the difference between two dates

use Datrim\DateRange\DateRange;

$today = DateRange::thisWeek();
$diff  = $today->diff();

Is a date and time included in a date range

use Datrim\DateRange\DateRange;

$thisWeek = DateRange::thisWeek();
$today = Carbon::now();
$included = $thisWeek->includes($today);

Also included is a default timezone class.

The timezone class is used by the DateRange when creating new Carbon instances. Before using the DateRange class, set the default timezone as follows:, _(*4)

use Datrim\DateRange\dt;
use Datrim\DateRange\DateRange;

dt::defaultTimezone('Europe/Berlin');

$today = DateRange::thisWeek();

To get the default timezone, call the dt::defaultTimezone method with no parameters:, _(*5)

use Datrim\DateRange\dt;

$timezone = dt::defaultTimezone();

The dt class has several static methods that wrap Carbon creation methods:, _(*6)

dt::now($tz = null)
dt::parse($time = null, $tz = null)
dt::today($tz = null)
dt::tomorrow($tz = null)
dt::yesterday($tz = null)

A different timezone string may be passed to all the above methods to override the default timezone., _(*7)

That's it!, _(*8)

License

The HttpData package is open-sourced software licensed under the MIT license, _(*9)