A simple PHP API extension for DateTime.

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(2012)->addYears(4);

$officialDate = Carbon::now()->toRfc2822String();

$howOldAmI = Carbon::createFromDate(1975, 5, 21)->age;

$noonTodayLondonTime = Carbon::createFromTime(12, 0, 0, 'Europe/London');

$worldWillEnd = Carbon::createFromDate(2012, 12, 21, 'GMT');

// Don't really want to die so mock now
Carbon::setTestNow(Carbon::createFromDate(2000, 1, 1));

// comparisons are always done in UTC
if (Carbon::now()->gte($worldWillEnd)) {

// Phew! Return to normal behaviour

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

echo CarbonInterval::years(2)->minutes(2); // '2 ans 2 minutes'

$daysSinceEpoch = Carbon::createFromTimestamp(0)->diffInDays();

Getting Started

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.

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 Carbon.php from the repo and save the file into your project path somewhere.

require 'path/to/Carbon.php';

use Carbon\Carbon;

printf("Now: %s", Carbon::now());

Learn More

Looks good so far. What do I do next? Read the API docs.


Brian Nesbitt


Carbon is licensed under the MIT License - see the LICENSE file for details.

Why the name Carbon?

Read about Carbon Dating.