Merge pull request #2653 from Axum25/master

Added: 'Day, Month Day, Year' as a predefined date format
briannesbitt · Aug 16, 2022 · 1dd341d · 1dd341d
2 parents bdf4f4f + 020d5d8
commit 1dd341d
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 0 deletions.
diff --git a/src/Carbon/Traits/Converter.php b/src/Carbon/Traits/Converter.php
@@ -158,6 +158,21 @@ public function toFormattedDateString()
         return $this->rawFormat('M j, Y');
     }
 
+    /**
+     * Format the instance with the day, and a readable date
+     *
+     * @example
+     * ```
+     * echo Carbon::now()->toFormattedDayDateString();
+     * ```
+     *
+     * @return string
+     */
+    public function toFormattedDayDateString(): string
+    {
+        return $this->rawFormat('D, M j, Y');
+    }
+
     /**
      * Format the instance as time
      *

diff --git a/tests/Carbon/StringsTest.php b/tests/Carbon/StringsTest.php
@@ -219,6 +219,12 @@ public function testToDayDateTimeString()
         $this->assertSame('Thu, Dec 25, 1975 2:15 PM', $d->toDayDateTimeString());
     }
 
+    public function testToDayDateString()
+    {
+        $d = Carbon::create(1975, 12, 25, 14, 15, 16);
+        $this->assertSame('Thu, Dec 25, 1975', $d->toFormattedDayDateString());
+    }
+
     public function testToAtomString()
     {
         $d = Carbon::create(1975, 12, 25, 14, 15, 16);