DateTime Formats

           
 // days
 Carbon::SUNDAY = 0;
 Carbon::MONDAY = 1
 Carbon::SATURDAY = 6;
 
 // months
 Carbon::JANUARY = 1;
 Carbon::DECEMBER = 12;
 
 // x in y
 Carbon::YEARS_PER_MILLENNIUM = 1000;
 Carbon::YEARS_PER_CENTURY = 100;
 Carbon::YEARS_PER_DECADE = 10;
 Carbon::MONTHS_PER_YEAR = 12;
 Carbon::MONTHS_PER_QUARTER = 3;
 Carbon::QUARTERS_PER_YEAR = 4;
 Carbon::WEEKS_PER_YEAR = 52;
 Carbon::WEEKS_PER_MONTH = 4;
 Carbon::DAYS_PER_YEAR = 365;
 Carbon::DAYS_PER_WEEK = 7;
 Carbon::HOURS_PER_DAY = 24;
 Carbon::MINUTES_PER_HOUR = 60;
 Carbon::SECONDS_PER_MINUTE = 60;
 Carbon::MILLISECONDS_PER_SECOND = 1000;
 Carbon::MICROSECONDS_PER_MILLISECOND = 1000;
 Carbon::MICROSECONDS_PER_SECOND = 1000000;
 
 $minutesInAWeek = Carbon::DAYS_PER_WEEK * Carbon::HOURS_PER_DAY * Carbon::MINUTES_PER_HOUR;
        

           use Illuminate\Support\Carbon;
 
 Carbon::macro('ukShortFormat', function(){
     return $this->format('d/m/y');
 });
 
 Carbon::macro('toDefaultFormat', function(){
     return $this->ukShortFormat();
 });
        

           enum DateTimeFormats: string
 {
     case ISO_DATE = 'Y-m-d';
     case UK_SHORT = 'd/m/y';
     case UK_LONG = 'd F Y';
 }
 
 # usage
 now()->format(DateTimeFormat::UK_SHORT->value);
        

           class DateTimeFormat
 {
     public const ISO_DATE = 'Y-m-d';
     public const UK_SHORT = 'd/m/y';
     public const UK_LONG = 'd F Y';
 }
 
 # usage
 now()->format(DateTimeFormat::UK_SHORT);
        

           Carbon::macro('ukShortFormat', function(){
     return $this->format(DateTimeFormat::UK_SHORT);
 });
        

           use Illuminate\Support\Carbon;
 
 Blade::stringable(fn (Carbon $carbon) =>
     $carbon->format(DateTimeFormat::UK_SHORT)
 );
        

           use Illuminate\Support\Facades\Date;
 
 public function boot(){
     Date::use(CarbonImmutable::class);
 
     // then add your custom carbon formatters
     Date::macro('ukShortFormat', function(){
         return $this->format('d/m/y');
     });
 
     Date::macro('toDefaultFormat', function(){
         return $this->ukShortFormat();
     });
 }
        

           protected $casts = [
     // ...
     'created_at' => 'immutable_datetime' // no longer required
     // ...
 ];
        

           // last Friday of current month
 now()->lastOfMonth(Carbon\Carbon::FRIDAY)
 
 // first Friday of next month
 now()->addMonth()->firstOfMonth(Carbon\Carbon::FRIDAY)
        

           gmdate('H:i:s', $seconds = 817); // 00:13:37
 // Don't go over 24 hours (86,400 seconds)
 
 gmdate("j\d H:i:s", $seconds = 86410); // 2d 00:00:10
 
 gmdate("j:H:i:s", $seconds = 86410); // 2:00:00:10
        

           function simpleTimeFormat($seconds)
 {
     return $time->totalHours >= 1
   	    ? gmdate('g:i:s', $time->totalSeconds)
         : gmdate('i:s', $time->totalSeconds);
 }
        

           function youtubeFormat($seconds)
 {
     $time = $seconds instanceof Carbon\CarbonInterval
         ? $seconds
         : Carbon\CarbonInterval::seconds($seconds);
 
     return sprintf("%02d:%02d:%02d",
                 $time->totalHours,
                 $time->totalMinutes % 60,
                 $time->totalSeconds % 60
             );
 }
 
 youtubeFormat(CarbonInterval::seconds(817)) // "13:27"
 youtubeFormat(8170) // "02:16:10"
        

           Carbon\CarbonInterval::macro('youtubeFormat', function ()
 {
     $interval = $this;
     $totalSeconds = $interval->totalSeconds;
     
     $hours = intdiv($totalSeconds, 3600);
     $minutes = intdiv($totalSeconds % 3600, 60);
     $seconds = $totalSeconds % 60;
     
     return sprintf("%02d:%02d:%02d", $hours, $minutes, $seconds);
 });
 
 // usage
 CarbonInterval::seconds(86471)->youtubeFormat(); // "24:01:11"
        

           class YoutubeFormatCarbonMixin
 {
     public function youtubeFormat()
     {
         return function () {
             // self::this()->...
             // return YoutubeFormat function code here
         };
     }
 }
        

           trait YoutubeFormatCarbonMixin
 {
     public function youtubeFormat()
     {
         // self::this()->...
         // return YoutubeFormat function code here
     }
 }
        

           CarbonInterval::createFromFormat('H:i:s', '10:20:00'); // 10 hours 20 minutes
        

           Carbon\CarbonInterval::day()->totalSeconds; // 86400
 
 Carbon\CarbonInterval::week()->totalDays; // 7
 
 Carbon\CarbonInterval::days(2)->hours(1)->totalHours; // 25 (two days + 1 hour)
 
 Carbon\CarbonInterval::seconds(150)->totalMinutes; // 2.5
 
 (int) round(Carbon\CarbonInterval::seconds(150)->totalMinutes); // 3
 
 Carbon\CarbonInterval::seconds(817)->cascade()->forHumans(['short' => true]); // "13m 37s"
 
 Carbon\CarbonInterval::days(1)
   	->hours(3)
   	->minutes(45)
   	->seconds(3)
     ->youtubeFormat();
     // "27:45:03" => 27 hours, 45 minutes and 3 seconds
        

           now()->setSeconds(0);
 
 now()->setSeconds(0)->setMinutes(0);
 
 now()->startOfHour();
 
 now()->endOfHour();
 
 now()->startOfMonth();
 
 now()->endOfMonth()->next(Carbon\Carbon::WEDNESDAY);
        

           $dt = new \DateTime('first day of January 2008');
 $carbon = Carbon::instance($dt);
        

           CarbonPeriod::create(
     Carbon::now(),
     Carbon::now()->addDays(30)
 );