update

Author: tamedevelopers

Capsule/TimeHelper.php

@@ -0,0 +1,61 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tamedevelopers\Support\Capsule;
+
+use Tamedevelopers\Support\Country;
+
+
+class TimeHelper {
+
+    /**
+     * Set the timezone.
+     * @param string|null $timezone
+     * 
+     * @return string
+     */
+    static public function setPassedTimezone($timezone = null)
+    {
+        if(in_array($timezone, Country::timeZone())){
+            $timezone = $timezone;
+        } else{
+            $timezone = date_default_timezone_get() ?? 'UTC';
+        }
+
+        return $timezone;
+    }
+
+    /**
+     * Set Date Time 
+     * @param int|string|null $date
+     * 
+     * @return int|false
+     */
+    static public function setPassedDate($date = null)
+    {
+        if(empty($date)){
+            $date = date('M d Y', strtotime('this year January'));
+            $date = "Jan 01 1970";
+        }
+
+        if (is_numeric($date)) {
+            $date = date('M d Y', (int) $date);
+        }
+
+        return strtotime($date);
+    }
+    
+    /**
+     * Check if an Instance of Carbon
+     * - When using in Laravel, the Default Time Class automatically changed to Carbon by Laravel
+     *
+     * @param  mixed $date
+     * @return int
+     */
+    static public function carbonInstance($date) 
+    {
+        return $date?->timestamp ?? $date;
+    }
+
+}

Tame.php

@@ -956,6 +956,7 @@ static public function mask($str = null, ?int $length = 4, ?string $position = '
             return $str;
         }
 
+        // trim string
         $str = Str::trim($str);
 
         // Get the length of the string
@@ -980,25 +981,33 @@ static public function mask($str = null, ?int $length = 4, ?string $position = '
             $strMinusLength = abs(1);
         }
 
+        // to int
+        $length = (int) $length;
+
         // For left position
         if ($position == 'left') {
-            $length = (int) $length;
             if ($isEmail && $atPosition !== false) {
-                // Mask the left part of the string, including the "@" symbol
-                return mb_substr(mb_substr($str, 0, $atPosition, 'UTF-8'), 0, $length, 'UTF-8') . str_repeat($mask, $atPosition - $length) . mb_substr($str, $atPosition, null, 'UTF-8');
+                // extract email without the tld (top level domain)
+                $email = mb_substr($str, 0, mb_strpos($str, "@"));
+
+                // extract only the tld, to be added at the end
+                $tld = mb_substr($str, mb_strpos($str, "@"));
+
+                // now mask only the email using the middle position
+                $maskedString = self::mask($email, $length, 'middle');
+
+                return "{$maskedString}{$tld}";
             } else {
-                // Mask the entire string if it's not an email
-                return mb_substr($str, 0, $length, 'UTF-8') . str_repeat($mask, $strMinusLength);
+                return str_repeat($mask, $strMinusLength) . mb_substr($str, -$length, null, 'UTF-8');
             }
-        } elseif ($position == 'middle' || $position == 'center') {
+        } elseif (in_array($position, ['middle', 'center'])) {
             // Mask the middle part of the string
             $length = (int) round($length / 2);
 
             return mb_substr($str, 0, $length, 'UTF-8') . str_repeat($mask, $strMinusLength) . mb_substr($str, -$length, null, 'UTF-8');
         } else {
             // Mask the right part of the string
-            $length = (int) $length;
-            return str_repeat($mask, $strMinusLength) . mb_substr($str, -$length, null, 'UTF-8');
+            return mb_substr($str, 0, $length, 'UTF-8') . str_repeat($mask, $strMinusLength);
         }
     }
 

Tests/time.php

@@ -8,30 +8,32 @@
 
 // set the default time and timezone
 // helper function
-TameTime(
+$mainTime = TameTime(
     timezone: 'Africa/Lagos',
-    time: 'now', 
+    time: 'now',
 );
 
-
 // Time::setDate('last week');
-// Time::setTimezone('Asia/Tokyo');
-
-// TameTime()->setDate('last week');
-// TameTime()->setTimezone('Asia/Tokyo');
+// Time::setTimezone('Pacific/Pago_Pago');
 
-// Time::setDate('last week');
 // TameTime('yesterday')->time();
 // TameTime('last week')->sec();
 
+$time2 = Time::setTimezone('Atlantic/South_Georgia');
+$time3 = Time::setTimezone('Indian/Antananarivo');
+
 dd(
+    TameTime()->format('yesterday')->ago(),
+    TameTime()->toJs('now'),
 
-    Time::setTimezone('Asia/Tokyo')
-        ->format('now')
-        ->ago()
-    ,
+    Time::setTimezone('Asia/Tokyo'),
 
-    TameTime()->format('yesterday')->ago(),
+    $mainTime->format('last year december'),
+    $mainTime->getTimeZone(),
+
+    $time2->format('this year october')->ago(),
+    $time2->getTimeZone(),
 
-    TameTime()->toJs('now')
+    $time3,
+    $time3->greetings()
 );