Latest Stable Version Total Downloads GitHub Actions Tidelift

    An international PHP extension for DateTime.

    use Carbon\Carbon;
    printf("Right now is %s", Carbon::now()->toDateTimeString());
    printf("Right now in Vancouver is %s", Carbon::now('America/Vancouver'));  //implicit __toString()
    $tomorrow = Carbon::now()->addDay();
    $lastWeek = Carbon::now()->subWeek();
    $nextSummerOlympics = Carbon::createFromDate(2016)->addYears(4);
    $officialDate = Carbon::now()->toRfc2822String();
    $howOldAmI = Carbon::createFromDate(1975, 5, 21)->age;
    $noonTodayLondonTime = Carbon::createFromTime(12, 0, 0, 'Europe/London');
    $internetWillBlowUpOn = Carbon::create(2038, 01, 19, 3, 14, 7, 'GMT');
    // Don't really want this to happen so mock now
    Carbon::setTestNow(Carbon::createFromDate(2000, 1, 1));
    // comparisons are always done in UTC
    if (Carbon::now()->gte($internetWillBlowUpOn)) {
    // Phew! Return to normal behaviour
    if (Carbon::now()->isWeekend()) {
        echo 'Party!';
    // Over 200 languages (and over 500 regional variants) supported:
    echo Carbon::now()->subMinutes(2)->diffForHumans(); // '2 minutes ago'
    echo Carbon::now()->subMinutes(2)->locale('zh_CN')->diffForHumans(); // '2分钟前'
    echo Carbon::parse('2019-07-23 14:51')->isoFormat('LLLL'); // 'Tuesday, July 23, 2019 2:51 PM'
    echo Carbon::parse('2019-07-23 14:51')->locale('fr_FR')->isoFormat('LLLL'); // 'mardi 23 juillet 2019 14:51'
    // ... but also does 'from now', 'after' and 'before'
    // rolling up to seconds, minutes, hours, days, months, years
    $daysSinceEpoch = Carbon::createFromTimestamp(0)->diffInDays();

    Get supported nesbot/carbon with the Tidelift Subscription


    With Composer

    $ composer require nesbot/carbon
        "require": {
            "nesbot/carbon": "^2.16"
    require 'vendor/autoload.php';
    use Carbon\Carbon;
    printf("Now: %s", Carbon::now());

    Without Composer

    Why are you not using composer? Download the Carbon latest release and put the contents of the ZIP archive into a directory in your project. Then require the file autoload.php to get all classes and dependencies loaded on need.

    require 'path-to-Carbon-directory/autoload.php';
    use Carbon\Carbon;
    printf("Now: %s", Carbon::now());


    Security contact information

    To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.



    This project exists thanks to all the people who contribute.


    Thanks to people helping us to translate Carbon in so many languages


    Support this project by becoming a sponsor. Your logo will show up here with a link to your website.

    [Become a sponsor]


    Thank you to all our backers! 🙏

    [Become a backer]

    Carbon for enterprise

    Available as part of the Tidelift Subscription.

    The maintainers of Carbon and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.


    🚀 Github 镜像仓库 🚀


    发行版本 111



    贡献者 267



    • PHP 100.0 %
    • Batchfile 0.0 %