From 79f06f9f04b0e0a3e7a3aa6b432b8991e8fbd7c4 Mon Sep 17 00:00:00 2001
From: Yasen Pramatarov <yasen@lindeas.com>
Date: Wed, 28 Jan 2026 19:30:56 +0200
Subject: [PATCH] Adds a centralized datetime helper

---
 app/helpers/datetime.php | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)
 create mode 100644 app/helpers/datetime.php

diff --git a/app/helpers/datetime.php b/app/helpers/datetime.php
new file mode 100644
index 0000000..1511d30
--- /dev/null
+++ b/app/helpers/datetime.php
@@ -0,0 +1,24 @@
+<?php
+
+/**
+ * Datetime helper utilities.
+ *
+ * Centralized formatting for UTC timestamps into a specified timezone.
+ */
+
+if (!function_exists('app_format_local_datetime')) {
+    function app_format_local_datetime(?string $value, string $format, string $timezone): string
+    {
+        if (empty($value) || $value === '0000-00-00 00:00:00') {
+            return '';
+        }
+        try {
+            $utc = new DateTimeZone('UTC');
+            $tz = new DateTimeZone($timezone ?: 'UTC');
+            $date = new DateTimeImmutable($value, $utc);
+            return $date->setTimezone($tz)->format($format);
+        } catch (Throwable $e) {
+            return '';
+        }
+    }
+}