Create ExtendedCarbon

app/ExtendedCarbon.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App;
+
+use Illuminate\Support\Carbon;
+
+class ExtendedCarbon extends Carbon
+{
+    /**
+     * Get the year and week formatted as a string in the ISO 8601 week date format.
+     *
+     * @return string The formatted year-week string.
+     * ```
+     * '2024-W25'
+     * ```
+     */
+    public function yearWeekString(): string
+    {
+        if ($this->week < 10 && !str_contains($this->week, '0')) {
+            $week = "0$this->week";
+        }
+        return "$this->year-W$week";
+    }
+
+    /**
+     * Get the closest date and time from `$this` in the array of dates.
+     *
+     * @param array<Carbon|ExtendedCarbon|string> $dates An array of dates to compare against the target.
+     * @return ExtendedCarbon|null The closest date and time from the array compared to the target.
+     */
+    public function closestFromDateArray(array $dates)
+    {
+        $closest = null;
+        foreach ($dates as $date) {
+            $current = ExtendedCarbon::parse($date);
+            if (is_null($closest)) {
+                $closest = $current;
+                continue;
+            }
+            $closest = $this->closest($closest, $current) === $current ? $current : $closest;
+        }
+        return $closest;
+    }
+}

app/Helpers.php

@@ -37,19 +37,4 @@ public static function getGoogleMapsUrl($lat, $lng)
     {
         return "https://maps.google.com/maps?q=$lat,$lng";
     }
-
-    /**
-     * Get the year and week formatted as a string in the ISO 8601 week date format.
-     *
-     * @param string|int $week The week number to format.
-     * @param string|int $year The year to format.
-     * @return string The formatted year-week string.
-     */
-    public static function yearWeekString(string|int $week, string|int $year): string
-    {
-        if ($week < 10 && !str_contains($week, '0')) {
-            $week = "0$week";
-        }
-        return "$year-W$week";
-    }
 }

app/Models/Attendance.php

@@ -2,6 +2,7 @@
 
 namespace App\Models;
 
+use App\ExtendedCarbon;
 use App\Helpers;
 use Illuminate\Contracts\Auth\Authenticatable;
 use Illuminate\Database\Eloquent\Casts\Attribute;
@@ -80,8 +81,9 @@ public function attachmentUrl(): ?Attribute
     public static function clearUserAttendanceCache(Authenticatable $user, Carbon $date)
     {
         if (is_null($user)) return false;
+        $date = new ExtendedCarbon($date);
         $monthYear = "$date->month-$date->year";
-        $week = Helpers::yearWeekString($date->week, $date->year);
+        $week = $date->yearWeekString();
         $ymd = $date->format('Y-m-d');
 
         try {