[12.x] Add milliseconds, weeks, and months duration helpers to Illuminate\Support (#57997)

* add-milliseconds-weeks-and-months-helpers

* Update functions.php

* Add microseconds

For when a smaller unit than milliseconds is needed, or a decimal value of milliseconds

Author: SanderMuller

src/Illuminate/Support/functions.php

@@ -66,6 +66,26 @@ function now($tz = null): CarbonInterface
     }
 }
 
+if (! function_exists('Illuminate\Support\microseconds')) {
+    /**
+     * Get the current date / time plus the given number of microseconds.
+     */
+    function microseconds(int $microseconds): CarbonInterval
+    {
+        return CarbonInterval::microseconds($microseconds);
+    }
+}
+
+if (! function_exists('Illuminate\Support\milliseconds')) {
+    /**
+     * Get the current date / time plus the given number of milliseconds.
+     */
+    function milliseconds(int $milliseconds): CarbonInterval
+    {
+        return CarbonInterval::milliseconds($milliseconds);
+    }
+}
+
 if (! function_exists('Illuminate\Support\seconds')) {
     /**
      * Get the current date / time plus the given number of seconds.
@@ -106,6 +126,26 @@ function days(int $days): CarbonInterval
     }
 }
 
+if (! function_exists('Illuminate\Support\weeks')) {
+    /**
+     * Get the current date / time plus the given number of weeks.
+     */
+    function weeks(int $weeks): CarbonInterval
+    {
+        return CarbonInterval::weeks($weeks);
+    }
+}
+
+if (! function_exists('Illuminate\Support\months')) {
+    /**
+     * Get the current date / time plus the given number of months.
+     */
+    function months(int $months): CarbonInterval
+    {
+        return CarbonInterval::months($months);
+    }
+}
+
 if (! function_exists('Illuminate\Support\years')) {
     /**
      * Get the current date / time plus the given number of years.