Laravel Carbon Class Usage

Carbon Time Handling Applications:

        echo Carbon::now();                                                 // Get current time
        echo Carbon::now('Arctic/Longyearbyen');                         // Get time in specified timezone
        echo Carbon::now(new \DateTimeZone('Europe/London'));            // Get time in specified timezone
        echo Carbon::today();                                               // Get today's date, time is 00-00-00
        echo  Carbon::tomorrow('Europe/London');                         // Get tomorrow's date
        echo Carbon::yesterday();                                           // Get yesterday's date
        echo Carbon::now()->timestamp;                                           // Get current timestamp
        // The above results output a Carbon date-time object
        /**
         * Carbon {#179 ▼
         * +"date": "2016-06-14 00:00:00.000000"
         * +"timezone_type": 3
         * +"timezone": "UTC"
         * }
         */

Get a String

        echo Carbon::today()->toDateTimeString();                            // Get today's date with time
        echo Carbon::yesterday()->toDateTimeString();
        echo Carbon::tomorrow()->toDateTimeString();
        echo Carbon::today()->toDateString();                                // Get today's date without time
        echo Carbon::yesterday()->toDateString();
        echo Carbon::tomorrow()->toDateString();

Date Parsing:

        echo Carbon::parse('2018-12-27')->toDateString();             //2018-12-27
        echo Carbon::parse('2016-12-27')->toDateTimeString();         //2018-12-27 00:00:00
        echo Carbon::parse('2016-12-27 00:10:25')->toDateTimeString(); //2018-12-27 00:10:25
        echo Carbon::parse('2016-12-27 00:10:25')->timestamp;       //Get timestamp of a date
        echo Carbon::parse('today')->toDateTimeString();            //Get today's date
        echo Carbon::parse('yesterday')->toDateTimeString();        //Get yesterday's date
        echo Carbon::parse('tomorrow')->toDateTimeString();         // Get tomorrow's date
        echo Carbon::parse('2 days ago')->toDateTimeString();       // Get the date two days ago
        echo Carbon::parse('+3 days')->toDateTimeString();       // Get the date three days later
        echo Carbon::parse('+2 weeks')->toDateTimeString();      // Get the date two weeks later
        echo Carbon::parse('+4 months')->toDateTimeString();      // Get the date four months later
        echo Carbon::parse('-1 year')->toDateTimeString();      // Get the date one year ago today
        echo Carbon::parse('next wednesday')->toDateTimeString(); // Get the date of next Wednesday
        echo Carbon::parse('last friday')->toDateTimeString();    // Get the date of last Friday
        var_dump(Carbon::now()->isWeekday());  //Is it a weekday
        var_dump(Carbon::parse('2018-12-29')->isWeekday());
        var_dump(Carbon::now()->isWeekend());  //Is it a weekend
        var_dump(Carbon::parse('2018-12-29')->isWeekend());
        var_dump(Carbon::parse('2018-12-26')->isYesterday()); //Is it yesterday
        var_dump(Carbon::parse('2018-12-26')->isToday()); //Is it today
        var_dump(Carbon::parse('2018-12-26')->isTomorrow()); //Is it tomorrow
        var_dump(Carbon::createFromDate(1991,10,24)->isBirthday()); //Is today birthday

Constructing Dates

        echo Carbon::createFromDate('2018', '12', '27');  //2018-12-27 02:21:53   Construct year and month
        echo Carbon::createFromDate('2018', '12', '27','Asia/Taipei');  //2018-12-27 10:22:12  //Construct year and month with timezone
        echo Carbon::createFromTime('12', '59', '52');   // Construct hour, minute, second for current time
        echo Carbon::create('2018', '12', '27', '12', '59', '52', 'Asia/Taipei'); //Construct full date and time
        echo Carbon::createFromFormat('Y/m/d H', '2018/05/21 22')->toDateTimeString(); // Construct time with specified format
        echo Carbon::createFromTimeStamp(1545877701)->toDateTimeString();    //Construct time from timestamp
        echo Carbon::createFromTimeStamp(1545877701,'Asia/Taipei')->toDateTimeString();    //Construct time from timestamp and timezone
        echo Carbon::createFromTimeStampUTC(1545877701)->toDateTimeString();    //Construct time from timestamp and UTC timezone

Getting Date Information:

        $time = Carbon::now();
        var_dump($time->year);   //Get current year
        var_dump($time->month);   //Get current month
        var_dump($time->day);   //Get current day
        var_dump($time->hour);   //Get current hour
        var_dump($time->minute);   //Get current minute
        var_dump($time->second);   //Get current second
        var_dump($time->micro);   //Get current microsecond
        var_dump($time->dayOfWeek);   //Get the day of the week
        var_dump($time->dayOfYear);   //Get the day of the year
        var_dump($time->weekOfMonth);   //Get the week of the month
        var_dump($time->weekOfYear);   //Get the week of the year
        var_dump($time->daysInMonth);   //Get days in the month
        var_dump(Carbon::createFromDate(1991, 10, 24)->age); //Get age from 1991,10,24 to now

Date Operations:

        echo Carbon::now()->addDays(25);   //Add 25 days to current time
        echo Carbon::now()->addWeeks(3);   //Add 3 weeks to current time
        echo Carbon::now()->addHours(25);   //Add 25 hours to current time
        echo Carbon::now()->subHours(2);    //Subtract 2 hours from current time
        echo Carbon::now()->addHours(2)->addMinutes(12);
        echo Carbon::now()->modify('+25 days'); //Add 25 days to current time
        echo Carbon::now()->modify('-2 days'); //Subtract 2 days from current time

Date Comparison:

        echo Carbon::now()->tzName;   //Get current timezone
        $first = Carbon::create(2018, 12, 5, 23, 26, 11);
        $second = Carbon::create(2018, 9, 5, 20, 26, 11);
        echo $first->toDateTimeString();
        echo $second->toDateTimeString();
        /**
         * min – returns the minimum date.
         * max – returns the maximum date.
         * eq – checks if two dates are equal.
         * gt – checks if the first date is greater than the second.
         * lt – checks if the first date is less than the second.
         * gte – checks if the first date is greater than or equal to the second.
         * lte – checks if the first date is less than or equal to the second.
         */
        var_dump($first->eq($second));
        var_dump($first->ne($second));
        var_dump($first->gt($second));
        var_dump($first->gte($second));
        var_dump($first->lt($second));
        var_dump($first->lte($second));
        //Interval comparison
        $first = Carbon::create(2018, 10, 5, 1);
        $second = Carbon::create(2018, 10, 5, 5);
        var_dump(Carbon::create(2018, 10, 5, 3)->between($first, $second));          // bool(true)
        var_dump(Carbon::create(2018, 10, 5, 5)->between($first, $second));          // bool(true)
        var_dump(Carbon::create(2018, 10, 5, 5)->between($first, $second, false));   // bool(false)

Get Special Times:

echo Carbon::now()->startOfDay();  //Start of today
echo Carbon::now()->endOfDay();  //End of today
echo Carbon::now()->startOfWeek(); //Start of this week
echo Carbon::now()->endOfWeek(); //End of this week
echo Carbon::now()->startOfMonth(); //Start of this month
echo Carbon::now()->endOfMonth(); //End of this month