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)) {
die();
}
// Phew! Return to normal behaviour
Carbon::setTestNow();
if (Carbon::now()->isWeekend()) {
echo 'Party!';
}
echo Carbon::now()->subMinutes(2)->diffForHumans(); // '2 minutes ago'
// ... but also does 'from now', 'after' and 'before'
// rolling up to seconds, minutes, hours, days, months, years
CarbonInterval::setLocale('fr');
echo CarbonInterval::years(2)->minutes(2); // '2 ans 2 minutes'
$daysSinceEpoch = Carbon::createFromTimestamp(0)->diffInDays();
1.x is compatible with PHP 5.3+.
A 2.x version is in the works and will require PHP 5.4+.
The easiest and recommended method to install Carbon is via composer.
Use the following command to install with composer.
$ composer require nesbot/carbon
This will automatically get the latest version and configure a composer.json
file.
<?php
require 'vendor/autoload.php';
use Carbon\Carbon;
printf("Now: %s", Carbon::now());
If you wish you can create the following composer.json
file and run composer install
to install it.
{
"require": {
"nesbot/carbon": "~1.18"
}
}
Why are you not using composer?
Download the last release (or any other you want) here: releases.
Release package is the asset named Carbon-x.y.z.zip where x.y.z is the version number.
Extract the zip in a directory in your project, then require the autoload.php file to make any Carbon class available:
<?php
require 'path/to/Carbon/autoload.php';
use Carbon\Carbon;
use Carbon\CarbonInterval;
printf("Now: %s", Carbon::now());
printf("1 day: %s", CarbonInterval::day()->forHumans());
Those packages contain symfony/translation to make diffForHumans
method vailable in different languages.
Install with composer is still a better option since it allows you to get the symfony/translation (and possible future dependencies) version that suit the best your PHP version and keep the whole think up-to-date via composer update
command.
Carbon is licensed under the MIT License - see the LICENSE
file for details.
Read about Carbon Dating.