feat: add date and boolean formatting functions to helpers

Author: tanhongit

common/helpers.php

@@ -2,15 +2,54 @@
 
 if (!function_exists('color_value_format')) {
     /**
-     * @param  string  $value
-     * @param  string  $color
+     * Format a value with an optional color.
      *
+     * @param  string  $value
+     * @param  string|null  $color
      * @return string
      */
-    function color_value_format(string $value, string $color): string
+    function color_value_format(string $value, ?string $color = null): string
     {
-        $value = str_replace(' ', ' \space ', $value);
+        if (empty($color)) {
+            return $value;
+        }
 
         return '$${\color{'.$color.'}'.$value.'}$$';
     }
 }
+
+if (!function_exists('format_date')) {
+    /**
+     * Format a date string.
+     *
+     * @param  string|null  $date
+     * @param  string  $format
+     *
+     * @return string|null
+     */
+    function format_date(?string $date, string $format = 'Y-m-d'): ?string
+    {
+        if (!$date) {
+            return null;
+        }
+
+        try {
+            return \Carbon\Carbon::parse($date)->format($format);
+        } catch (\Exception $e) {
+            return $date;
+        }
+    }
+}
+
+if (!function_exists('format_boolean')) {
+    /**
+     * Format a boolean value.
+     *
+     * @param  mixed  $value
+     * @return string
+     */
+    function format_boolean($value): string
+    {
+        return filter_var($value, FILTER_VALIDATE_BOOLEAN) ? '✅' : '❌';
+    }
+}