Dati 0.4.0

Author: nabeghe

README.md

@@ -8,7 +8,7 @@ Includes the following helpers:
 - [Buildify](https://github.com/nabeghe/buildify-php) <small>v1.0.1</small>
 - [Cally](https://github.com/nabeghe/cally-php) <small>v0.1.0</small>
 - [Colory](https://github.com/nabeghe/colory-php) <small>v0.1.0</small>
-- [Dati](https://github.com/nabeghe/dati-php) <small>v0.3.1</small>
+- [Dati](https://github.com/nabeghe/dati-php) <small>v0.4.0</small>
 - [FileSize](https://github.com/nabeghe/file-size-php) <small>v1.0.0</small>
 - [HeadersReader](https://github.com/nabeghe/headers-reader-php) <small>v1.0.1</small>
 - [Levex](https://github.com/nabeghe/levex-php) <small>v1.0.1</small>

src/Dati/Dati.php

@@ -2,6 +2,7 @@
 
 use DateTime;
 use DateTimeZone;
+use IntlTimeZone;
 use Throwable;
 use IntlDateFormatter;
 
@@ -479,4 +480,38 @@ public static function toLocal($datetime, $format = null)
     {
         return static::toTimeZone($datetime, 'GMT', date_default_timezone_get(), $format);
     }
+
+    /**
+     * Returns a human-readable display name for a timezone in the given locale.
+     *
+     * @param  string  $locale  Locale for formatting (e.g., 'en_US', 'en', 'fa_IR', 'fa')
+     * @param  string|null  $timezone  Optional timezone ID (e.g., 'Asia/Tehran'). Defaults to system timezone.
+     * @return string|null Display name of the timezone, or null on error.
+     */
+    public static function getTimeZoneDisplayName(string $locale = 'en', ?string $timezone = null): ?string
+    {
+        $timezone ??= date_default_timezone_get();
+
+        if (class_exists('IntlDateFormatter')) {
+            try {
+                $formatter = new IntlDateFormatter(
+                    $locale,
+                    IntlDateFormatter::FULL,
+                    IntlDateFormatter::FULL,
+                    $timezone,
+                    null,
+                );
+
+                $date_time_zone = new DateTimeZone($timezone);
+
+                $display_name = $formatter->getTimeZone()->getDisplayName(false, IntlTimeZone::DISPLAY_LONG, $locale);
+                if ($display_name !== false) {
+                    return $display_name;
+                }
+            } catch (Throwable $e) {
+            }
+        }
+
+        return null;
+    }
 }