Implemented #9

lib/DateTime/Readers.php

@@ -12,6 +12,7 @@
 namespace ICanBoogie\DateTime;
 
 use ICanBoogie\DateTime;
+use ICanBoogie\MutableDateTime;
 use ICanBoogie\PropertyNotDefined;
 use ICanBoogie\TimeZone;
 
@@ -69,6 +70,9 @@
  * @property-read bool $is_utc `true` if the instance is in the UTC timezone.
  * @property-read bool $is_local `true` if the instance is in the local timezone.
  * @property-read bool $is_dst `true` if time occurs during Daylight Saving Time in its time zone.
+ *
+ * @property-read DateTime $immutable An immutable representation of the instance.
+ * @property-read MutableDateTime $mutable A mutable representation of the instance.
  */
 trait Readers
 {
@@ -148,6 +152,8 @@ public function __get($property)
 			case 'sunday':
 			case 'tomorrow':
 			case 'yesterday':
+			case 'mutable':
+			case 'immutable':
 				return $this->{ 'get_' . $property }();
 
 			case 'zone':
@@ -279,4 +285,20 @@ protected function get_yesterday()
 			->modify('-1 day')
 			->setTime(0, 0, 0);
 	}
+
+	/**
+	 * @return MutableDateTime
+	 */
+	protected function get_mutable()
+	{
+		return MutableDateTime::from($this);
+	}
+
+	/**
+	 * @return DateTime
+	 */
+	protected function get_immutable()
+	{
+		return DateTime::from($this);
+	}
 }

tests/AbstractDateTimeTest.php

@@ -993,6 +993,22 @@ public function provide_read_only_properties()
 
 			return [ $property ];
 
-		}, explode(' ', 'quarter week weekday year_day is_monday is_tuesday is_wednesday is_thursday is_friday is_saturday is_sunday is_today is_past is_future is_empty tomorrow yesterday monday tuesday wednesday thursday friday saturday sunday is_utc is_local is_dst as_atom as_cookie as_iso8601 as_rfc822 as_rfc850 as_rfc1036 as_rfc1123 as_rfc2822 as_rfc3339 as_rss as_w3c as_db as_number as_date as_time utc local'));
+		}, explode(' ', 'quarter week weekday year_day is_monday is_tuesday is_wednesday is_thursday is_friday is_saturday is_sunday is_today is_past is_future is_empty tomorrow yesterday monday tuesday wednesday thursday friday saturday sunday is_utc is_local is_dst as_atom as_cookie as_iso8601 as_rfc822 as_rfc850 as_rfc1036 as_rfc1123 as_rfc2822 as_rfc3339 as_rss as_w3c as_db as_number as_date as_time utc local mutable immutable'));
+	}
+
+	public function test_get_mutable()
+	{
+		$datetime = $this->create();
+		$mutable = $datetime->mutable;
+		$this->assertNotSame($datetime, $mutable);
+		$this->assertInstanceOf(MutableDateTime::class, $mutable);
+	}
+
+	public function test_get_immutable()
+	{
+		$datetime = $this->create();
+		$immutable = $datetime->immutable;
+		$this->assertNotSame($datetime, $immutable);
+		$this->assertInstanceOf(DateTime::class, $immutable);
 	}
 }