refs #1486 added method to detect whether current year is a leap year

2 files changed, 39 insertions, 0 deletions

diff --git a/core/Date.php b/core/Date.php
index 3b21ed186a..063420940c 100644
--- a/core/Date.php
+++ b/core/Date.php
@@ -290,6 +290,18 @@ class Date
     }
 
     /**
+     * Returns `true` if the current year is a leap year, false otherwise.
+     *
+     * @return bool
+     */
+    public function isLeapYear()
+    {
+        $currentYear = date('Y', $this->getTimestamp());
+
+        return ($currentYear % 400) == 0 || (($currentYear % 4) == 0 && ($currentYear % 100) != 0);
+    }
+
+    /**
      * Converts this date to the requested string format. See {@link http://php.net/date}
      * for the list of format strings.
      *
diff --git a/tests/PHPUnit/Core/DateTest.php b/tests/PHPUnit/Core/DateTest.php
index ad4252c1a4..28133e5ea1 100644
--- a/tests/PHPUnit/Core/DateTest.php
+++ b/tests/PHPUnit/Core/DateTest.php
@@ -238,4 +238,31 @@ class DateTest extends PHPUnit_Framework_TestCase
         $date = $date->subPeriod(5, 'year');
         $this->assertEquals($dateExpected->getTimestamp(), $date->getTimestamp());
     }
+
+    /**
+     * @group Core
+     */
+    public function testIsLeapYear()
+    {
+        $date = Date::factory('2011-03-01');
+        $this->assertFalse($date->isLeapYear());
+        $date = Date::factory('2011-01-01');
+        $this->assertFalse($date->isLeapYear());
+        $date = Date::factory('2011-01-31');
+        $this->assertFalse($date->isLeapYear());
+
+        $date = Date::factory('2012-01-01');
+        $this->assertTrue($date->isLeapYear());
+        $date = Date::factory('2012-12-31');
+        $this->assertTrue($date->isLeapYear());
+
+        $date = Date::factory('2013-01-01');
+        $this->assertFalse($date->isLeapYear());
+        $date = Date::factory('2013-12-31');
+        $this->assertFalse($date->isLeapYear());
+
+        $date = Date::factory('2052-01-01');
+        $this->assertTrue($date->isLeapYear());
+
+    }
 }