Seven Very Useful Carbon Methods in Laravel

When writing PHP applications, we often need to deal with dates and times. Carbon inherits from the API extension of the PHP DateTime class, which makes it easier to deal with dates and times. This article mainly shares with you seven very useful but few people in Laravel. If you know the Carbon method, friends in need can refer to it.

Preface

Everyone should know that we use Carbon to handle dates and times many times, right? But how many people have read the complete document to understand what methods it has? In addition to the well-known now() and format() methods, Carbon has many other useful methods.

Let’s take a look.

1. isX: True/False

There are many ways to determine whether the Carbon object is today, weekend, leap year, etc. The following are listed in the official documentation:

<?php
$dt->isWeekday();
$dt->isWeekend();
$dt->isYesterday();
$dt->isToday();
$dt->isTomorrow();
$dt->isFuture();
$dt->isPast();
$dt->isLeapYear();
$dt->isSameDay(Carbon::now());

2. isBirthday

In addition to the above list, Carbon also has a method to determine whether a date is someone's birthday. In addition to checking the month and day individually, you can also do this:

$born = Carbon::createFromDate(1987, 4, 23);
$noCake = Carbon::createFromDate(2014, 9, 26);
$yesCake = Carbon::createFromDate(2014, 4, 23);
var_dump($born->isBirthday($noCake));  // bool(false)
var_dump($born->isBirthday($yesCake));

3. StartOfX and EndOfX lists

The following are the startOfX series and endOfX series:

$dt = Carbon::create(2012, 1, 31, 12, 0, 0);
echo $dt->startOfDay(); // 2012-01-31 00:00:00
echo $dt->endOfDay(); // 2012-01-31 23:59:59
echo $dt->startOfMonth(); // 2012-01-01 00:00:00
echo $dt->endOfMonth(); // 2012-01-31 23:59:59
echo $dt->startOfYear(); // 2012-01-01 00:00:00
echo $dt->endOfYear(); // 2012-12-31 23:59:59
echo $dt->startOfDecade(); // 2010-01-01 00:00:00
echo $dt->endOfDecade(); // 2019-12-31 23:59:59
echo $dt->startOfCentury(); // 2000-01-01 00:00:00
echo $dt->endOfCentury(); // 2099-12-31 23:59:59
echo $dt->startOfWeek(); // 2012-01-30 00:00:00
echo $dt->endOfWeek(); // 2012-02-05 23:59:59

4. Today, Tomorrow, Yesterday

Three simple but very useful methods, no need to call now(), then replace the hours, minutes and seconds, and then add or subtract the number of days:

$today = Carbon::today(); // assuming 2016-06-24
echo $today;        // 2016-06-24 00:00:00
$tomorrow = Carbon::tomorrow();
echo $tomorrow;       // 2016-06-25 00:00:00
$yesterday = Carbon::yesterday();
echo $yesterday;       // 2016-06-23 00:00:00

5. DiffForHumans + Localization

You may have used this method called diffForHumans() – it returns the difference between two dates in a human-readable way:

echo Carbon::now()->subDays(5)->diffForHumans(); // 5 days ago

But did you know it can also be localized? Just change the location, such as Chinese:

Carbon::setLocale('zh');
echo Carbon::now()->addYear()->diffForHumans(); // 一年前

6. Change now() to any time you want

$knownDate = Carbon::create(2001, 5, 21, 12); // 创建测试日期
Carbon::setTestNow($knownDate);      // set the mock 
echo Carbon::now();         // 2001-05-21 12:00:00

7. Weekday constant

You can use the following constants to replace the day of the week:

var_dump(Carbon::SUNDAY);       // int(0)
var_dump(Carbon::MONDAY);       // int(1)
var_dump(Carbon::TUESDAY);       // int(2)
var_dump(Carbon::WEDNESDAY);      // int(3)
var_dump(Carbon::THURSDAY);      // int(4)
var_dump(Carbon::FRIDAY);       // int(5)
var_dump(Carbon::SATURDAY);      // int(6)

Do you know all the useful methods mentioned above? You can list the methods you find useful in the comments.

Related recommendations:

Laravel date and time processing package Carbon

How to use date and time processing package Carbon in Laravel Example

#How to use date and time processor Carbon in php to realize humanized display of time

The above is the detailed content of Seven Very Useful Carbon Methods in Laravel. For more information, please follow other related articles on the PHP Chinese website!