Class ImmutableDateTime

Representation of a date and time.

<?php

// Let's say that _now_ is 2013-02-03 21:03:45 in Paris

use ICanBoogie\ImmutableDateTime;

date_default_timezone_set('EST'); // set local time zone to Eastern Standard Time

$time = new ImmutableDateTime('now', 'Europe/Paris');

echo $time;                             // 2013-02-03T21:03:45+01:00
echo $time->utc;                        // 2013-02-03T20:03:45Z
echo $time->local;                      // 2013-02-03T15:03:45-05:00
echo $time->utc->local;                 // 2013-02-03T15:03:45-05:00
echo $time->utc->is_utc;                // true
echo $time->utc->is_local;              // false
echo $time->local->is_utc;              // false
echo $time->local->is_local;            // true
echo $time->is_dst;                     // false

echo $time->as_rss;                     // Sun, 03 Feb 2013 21:03:45 +01:00
echo $time->as_db;                      // 2013-02-03 21:03:45

echo $time->as_time;                    // 21:03:45
echo $time->utc->as_time;               // 20:03:45
echo $time->local->as_time;             // 15:03:45
echo $time->utc->local->as_time;        // 15:03:45

echo $time->quarter;                    // 1
echo $time->week;                       // 5
echo $time->day;                        // 3
echo $time->minute;                     // 3
echo $time->is_monday;                  // false
echo $time->is_saturday;                // true
echo $time->is_today;                   // true
echo $time->tomorrow;                   // 2013-02-04T00:00:00+01:00
echo $time->tomorrow->is_future         // true
echo $time->yesterday;                  // 2013-02-02T00:00:00+01:00
echo $time->yesterday->is_past          // true
echo $time->monday;                     // 2013-01-28T00:00:00+01:00
echo $time->sunday;                     // 2013-02-03T00:00:00+01:00

echo $time->timestamp;                  // 1359921825
echo $time;                             // 2013-02-03T21:03:45+01:00
$time->timestamp += 3600 * 4;
echo $time;                             // 2013-02-04T01:03:45+01:00

echo $time->timezone;                   // Europe/Paris
// or
echo $time->tz;                         // Europe/Paris
echo $time->tz->offset;                 // 3600
echo $time->tz->location;               // FR,48.86667,2.33333
echo $time->tz->location->latitude;     // 48.86667

Empty dates are also supported:

<?php

use ICanBoogie\ImmutableDateTime as ImmutableDateTime;

$time = new DateTime('0000-00-00', 'utc');
// or
$time = DateTime::none();

echo $time->is_empty;                   // true
echo $time->as_date;                    // 0000-00-00
echo $time->as_db;                      // 0000-00-00 00:00:00
echo $time;                             // ""