Add shim for date filter

Handle Date values so that we maintain compatibility with twig
templates and date objects.

Fixes #97

src/Twig/Extension/TimeExtension.php

@@ -18,15 +18,35 @@
 
 namespace Cake\TwigView\Twig\Extension;
 
+use Cake\Chronos\ChronosDate;
 use Cake\I18n\DateTime;
+use DateInterval;
+use DateTimeInterface;
+use DateTimeZone;
 use Twig\Extension\AbstractExtension;
+use Twig\Extension\CoreExtension;
+use Twig\TwigFilter;
 use Twig\TwigFunction;
 
 /**
  * Class TimeExtension.
  */
 class TimeExtension extends AbstractExtension
 {
+    private ?CoreExtension $coreExt;
+
+    /**
+     * Get declared filters.
+     *
+     * @return array<\Twig\TwigFilter>
+     */
+    public function getFilters(): array
+    {
+        return [
+            new TwigFilter('date', [$this, 'formatDate']),
+        ];
+    }
+
     /**
      * Get declared functions.
      *
@@ -35,10 +55,37 @@ class TimeExtension extends AbstractExtension
     public function getFunctions(): array
     {
         return [
+            new TwigFunction('date', function ($time = null, $timezone = null) {
+                return new DateTime($time, $timezone);
+            }),
             new TwigFunction('time', function ($time = null, $timezone = null) {
                 return new DateTime($time, $timezone);
             }),
             new TwigFunction('timezones', 'Cake\I18n\DateTime::listTimezones'),
         ];
     }
+
+    /**
+     * Format a date/datetime value
+     *
+     * Includes shims for \Chronos\ChronosDate as Twig doesn't.
+     *
+     * @param \Chronos\ChronosDate|\DateTimeInterface|\DateInterval|string $date The date to format.
+     * @param ?string $format The format to use, null to use the default.
+     * @param \DateTimeZone|string|false|null $timezone The target timezone, null to use system.
+     */
+    public function formatDate(
+        ChronosDate|DateTimeInterface|DateInterval|string $date,
+        ?string $format = null,
+        DateTimeZone|string|false|null $timezone = null
+    ): string {
+        if (!isset($this->coreExt)) {
+            $this->coreExt = new CoreExtension();
+        }
+        if ($date instanceof ChronosDate) {
+            $date = $date->toDateTimeImmutable();
+        }
+
+        return $this->coreExt->formatDate($date, $format, $timezone);
+    }
 }

tests/TestCase/View/TwigViewTest.php

@@ -21,6 +21,7 @@
 use Cake\Core\Configure;
 use Cake\I18n\Date;
 use Cake\I18n\DateTime;
+use Cake\I18n\I18n;
 use Cake\TestSuite\TestCase;
 use TestApp\View\AppView;
 use Twig\Error\RuntimeError;
@@ -144,10 +145,15 @@ public function testCellsShareTwig()
      */
     public function testTwigDateFormat()
     {
+        $restore = I18n::getLocale();
+        I18n::setLocale('fr');
+
         $this->view->set('date', new Date('2024-06-24'));
         $this->view->set('datetime', new DateTime('2024-06-24 12:13:14'));
 
         $output = $this->view->render('date_format', false);
+        I18n::setLocale($restore);
+
         $expected = <<<TEXT
 Date: 2024/06/24
 Datetime: 2024/06/24 12:13:14