Date

A PHP library for working w/ dates.

Install

Normal install via Composer.

Usage

Some basic examples:

use Travis\Date;

// default timestamp is now
$date = Date::make();

// pass timestamps
$date = Date::make(1333857600);

// pass strings
$date = Date::make('last sunday');

// pass objects
$date = Date::make('last sunday');
$new_date = Date::make($date);

// get timestamp
$date = Date::make('last sunday')->time(); // 1333857600

// get a nice format
$date = Date::make('last sunday')->format('%B %d, %Y'); // April 08, 2012

// amend the timestamp value, relative to existing value
$date = Date::make('2012-04-05')->remake('+ 3 days')->format('%F'); // 2012-04-08

// amend the timestamp value, and keep original date object
$date = Date::make('2012-04-05');
$new_date = $date->remake('+3 days', true); // flag to return modified cloned object
echo $date->format('%F'); // 2013-04-05
echo $new_date->format('%F'); // 2014-04-08

// get relative 'ago' format
echo Date::make('now - 10 minutes')->ago() // 10 minutes ago

Math w/ Dates

Let's look at some date comparison examples:

// passing objects
$date1 = Date::make('2012-04-05');
$date2 = Date::make('2012-04-08');
$diff = Date::diff($date1, $date2);
/*
DateInterval Object
(
    [y] => 0
    [m] => 0
    [d] => 3
    [h] => 0
    [i] => 0
    [s] => 0
    [invert] => 0
    [days] => 3
)
*/

// passing timestamps
$diff = Date::diff(1333598400, 1333857600);
/*
DateInterval Object
(
    [y] => 0
    [m] => 0
    [d] => 3
    [h] => 0
    [i] => 0
    [s] => 0
    [invert] => 0
    [days] => 3
)
*/

// passing strings
$diff = Date::diff('April 08, 2012', 'April 05, 2012');
/*
DateInterval Object
(
    [y] => 0
    [m] => 0
    [d] => 3
    [h] => 0
    [i] => 0
    [s] => 0
    [invert] => 1
    [days] => 3
)
*/

Drawing Calendars

You can print a nice HTML table of a calendar:

$html = Date::draw_calendar($month, $year); // both params should be integers

You can print custom content inside the cells for a specific date by passing a closure:

$html = Date::draw_calendar($month, $year, function($date) use ($my_custom_param) {
    if ($date->format('%F') == $my_custom_param)
    {
        echo 'something special';
    }
});

Take a look at the view used in the package and you'll see what CSS options are available.

Notes

For help in building your formats, checkout the PHP strftime() docs.

swt83 / php-date