Getting Started

1.x is compatible with PHP 5.3+.
A 2.x version is in the works and will require PHP 5.4+.

Installing

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;

{{::lint(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.

<?php
require 'path/to/Carbon.php';

use Carbon\Carbon;

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

If you want to use diffForHumans() with this install mode, you will also need to download and load symfony/translation and its owns dependencies. But if you do, you should really consider using composer instead.

Learn More

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

Author

Brian Nesbitt
http://nesbot.com
http://twitter.com/NesbittBrian

License

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

Why the name Carbon?

Read about Carbon Dating.