Update facade docblocks

Author: taylorotwell

src/Illuminate/Support/Facades/Date.php

@@ -13,77 +13,96 @@
  * @method static void useCallable(callable $callable)
  * @method static void useClass(string $dateClass)
  * @method static void useFactory(object $factory)
- * @method static \Illuminate\Support\Carbon create($year = 0, $month = 1, $day = 1, $hour = 0, $minute = 0, $second = 0, $timezone = null)
+ * @method static bool canBeCreatedFromFormat(?string $date, string $format)
+ * @method static \Illuminate\Support\Carbon|null create($year = 0, $month = 1, $day = 1, $hour = 0, $minute = 0, $second = 0, $timezone = null)
  * @method static \Illuminate\Support\Carbon createFromDate($year = null, $month = null, $day = null, $timezone = null)
- * @method static \Illuminate\Support\Carbon|false createFromFormat($format, $time, $timezone = null)
+ * @method static \Illuminate\Support\Carbon|null createFromFormat($format, $time, $timezone = null)
+ * @method static \Illuminate\Support\Carbon|null createFromIsoFormat(string $format, string $time, $timezone = null, ?string $locale = 'en', ?TranslatorInterface $translator = null)
+ * @method static \Illuminate\Support\Carbon|null createFromLocaleFormat(string $format, string $locale, string $time, $timezone = null)
+ * @method static \Illuminate\Support\Carbon|null createFromLocaleIsoFormat(string $format, string $locale, string $time, $timezone = null)
  * @method static \Illuminate\Support\Carbon createFromTime($hour = 0, $minute = 0, $second = 0, $timezone = null)
- * @method static \Illuminate\Support\Carbon createFromTimeString($time, $timezone = null)
- * @method static \Illuminate\Support\Carbon createFromTimestamp($timestamp, $timezone = null)
- * @method static \Illuminate\Support\Carbon createFromTimestampMs($timestamp, $timezone = null)
- * @method static \Illuminate\Support\Carbon createFromTimestampUTC($timestamp)
+ * @method static \Illuminate\Support\Carbon createFromTimeString(string $time, DateTimeZone|string|int|null $timezone = null)
+ * @method static \Illuminate\Support\Carbon createFromTimestamp(string|int|float $timestamp, DateTimeZone|string|int|null $timezone = null)
+ * @method static \Illuminate\Support\Carbon createFromTimestampMs(string|int|float $timestamp, DateTimeZone|string|int|null $timezone = null)
+ * @method static \Illuminate\Support\Carbon createFromTimestampMsUTC($timestamp)
+ * @method static \Illuminate\Support\Carbon createFromTimestampUTC(string|int|float $timestamp)
  * @method static \Illuminate\Support\Carbon createMidnightDate($year = null, $month = null, $day = null, $timezone = null)
- * @method static \Illuminate\Support\Carbon|false createSafe($year = null, $month = null, $day = null, $hour = null, $minute = null, $second = null, $timezone = null)
+ * @method static \Illuminate\Support\Carbon|null createSafe($year = null, $month = null, $day = null, $hour = null, $minute = null, $second = null, $timezone = null)
+ * @method static \Illuminate\Support\Carbon createStrict(?int $year = 0, ?int $month = 1, ?int $day = 1, ?int $hour = 0, ?int $minute = 0, ?int $second = 0, $timezone = null)
  * @method static void disableHumanDiffOption($humanDiffOption)
  * @method static void enableHumanDiffOption($humanDiffOption)
- * @method static mixed executeWithLocale($locale, $func)
+ * @method static mixed executeWithLocale(string $locale, callable $func)
  * @method static \Illuminate\Support\Carbon fromSerialized($value)
  * @method static array getAvailableLocales()
+ * @method static array getAvailableLocalesInfo()
  * @method static array getDays()
+ * @method static ?string getFallbackLocale()
+ * @method static array getFormatsToIsoReplacements()
  * @method static int getHumanDiffOptions()
  * @method static array getIsoUnits()
- * @method static array getLastErrors()
+ * @method static array|false getLastErrors()
  * @method static string getLocale()
  * @method static int getMidDayAt()
+ * @method static string getTimeFormatByPrecision(string $unitPrecision)
+ * @method static string|Closure|null getTranslationMessageWith($translator, string $key, ?string $locale = null, ?string $default = null)
  * @method static \Illuminate\Support\Carbon|null getTestNow()
  * @method static \Symfony\Contracts\Translation\TranslatorInterface getTranslator()
- * @method static int getWeekEndsAt()
- * @method static int getWeekStartsAt()
+ * @method static int getWeekEndsAt(?string $locale = null)
+ * @method static int getWeekStartsAt(?string $locale = null)
  * @method static array getWeekendDays()
- * @method static bool hasFormat($date, $format)
+ * @method static bool hasFormat(string $date, string $format)
+ * @method static bool hasFormatWithModifiers(string $date, string $format)
  * @method static bool hasMacro($name)
- * @method static bool hasRelativeKeywords($time)
+ * @method static bool hasRelativeKeywords(?string $time)
  * @method static bool hasTestNow()
- * @method static \Illuminate\Support\Carbon instance($date)
+ * @method static \Illuminate\Support\Carbon instance(DateTimeInterface $date)
  * @method static bool isImmutable()
  * @method static bool isModifiableUnit($unit)
  * @method static bool isMutable()
  * @method static bool isStrictModeEnabled()
- * @method static bool localeHasDiffOneDayWords($locale)
- * @method static bool localeHasDiffSyntax($locale)
- * @method static bool localeHasDiffTwoDayWords($locale)
+ * @method static bool localeHasDiffOneDayWords(string $locale)
+ * @method static bool localeHasDiffSyntax(string $locale)
+ * @method static bool localeHasDiffTwoDayWords(string $locale)
  * @method static bool localeHasPeriodSyntax($locale)
- * @method static bool localeHasShortUnits($locale)
- * @method static void macro($name, $macro)
- * @method static \Illuminate\Support\Carbon|null make($var)
- * @method static \Illuminate\Support\Carbon maxValue()
- * @method static \Illuminate\Support\Carbon minValue()
- * @method static void mixin($mixin)
- * @method static \Illuminate\Support\Carbon now($timezone = null)
- * @method static \Illuminate\Support\Carbon parse($time = null, $timezone = null)
+ * @method static bool localeHasShortUnits(string $locale)
+ * @method static void macro(string $name, ?callable $macro)
+ * @method static \Illuminate\Support\Carbon|null make($var, DateTimeZone|string|null $timezone = null)
+ * @method static void mixin(object|string $mixin)
+ * @method static \Illuminate\Support\Carbon now(DateTimeZone|string|int|null $timezone = null)
+ * @method static \Illuminate\Support\Carbon parse(DateTimeInterface|WeekDay|Month|string|int|float|null $time, DateTimeZone|string|int|null $timezone = null)
+ * @method static \Illuminate\Support\Carbon parseFromLocale(string $time, ?string $locale = null, DateTimeZone|string|int|null $timezone = null)
  * @method static string pluralUnit(string $unit)
+ * @method static \Illuminate\Support\Carbon|null rawCreateFromFormat(string $format, string $time, $timezone = null)
+ * @method static \Illuminate\Support\Carbon rawParse(DateTimeInterface|WeekDay|Month|string|int|float|null $time, DateTimeZone|string|int|null $timezone = null)
  * @method static void resetMonthsOverflow()
  * @method static void resetToStringFormat()
  * @method static void resetYearsOverflow()
  * @method static void serializeUsing($callback)
+ * @method static void setFallbackLocale(string $locale)
  * @method static void setHumanDiffOptions($humanDiffOptions)
- * @method static bool setLocale($locale)
+ * @method static void setLocale(string $locale)
  * @method static void setMidDayAt($hour)
- * @method static void setTestNow($testNow = null)
- * @method static void setToStringFormat($format)
+ * @method static void setTestNow(mixed $testNow = null)
+ * @method static void setTestNowAndTimezone(mixed $testNow = null, $timezone = null)
+ * @method static void setToStringFormat(string|Closure|null $format)
  * @method static void setTranslator(\Symfony\Contracts\Translation\TranslatorInterface $translator)
- * @method static void setUtf8($utf8)
  * @method static void setWeekEndsAt($day)
  * @method static void setWeekStartsAt($day)
  * @method static void setWeekendDays($days)
  * @method static bool shouldOverflowMonths()
  * @method static bool shouldOverflowYears()
  * @method static string singularUnit(string $unit)
- * @method static \Illuminate\Support\Carbon today($timezone = null)
- * @method static \Illuminate\Support\Carbon tomorrow($timezone = null)
+ * @method static void sleep(int|float $seconds)
+ * @method static \Illuminate\Support\Carbon today(DateTimeZone|string|int|null $timezone = null)
+ * @method static \Illuminate\Support\Carbon tomorrow(DateTimeZone|string|int|null $timezone = null)
+ * @method static string translateTimeString(string $timeString, ?string $from = null, ?string $to = null, int $mode = CarbonInterface::TRANSLATE_ALL)
+ * @method static string translateWith(TranslatorInterface $translator, string $key, array $parameters = [], $number = null)
  * @method static void useMonthsOverflow($monthsOverflow = true)
  * @method static void useStrictMode($strictModeEnabled = true)
  * @method static void useYearsOverflow($yearsOverflow = true)
- * @method static \Illuminate\Support\Carbon yesterday($timezone = null)
+ * @method static mixed withTestNow(mixed $testNow, callable $callback)
+ * @method static static withTimeZone(DateTimeZone|string|int|null $timezone)
+ * @method static \Illuminate\Support\Carbon yesterday(DateTimeZone|string|int|null $timezone = null)
  *
  * @see \Illuminate\Support\DateFactory
  */