famdirksen / carbon
A simple API extension for DateTime.
1.22.3
2017-07-12 10:26 UTC
Requires
- php: >=5.3.0
- symfony/translation: ~2.6 || ~3.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ~2
- phpunit/phpunit: ~4.0 || ~5.0
README
A simple PHP API extension for DateTime. http://carbon.nesbot.com
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(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)) { 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 $daysSinceEpoch = Carbon::createFromTimestamp(0)->diffInDays();
Installation
With Composer
$ composer require nesbot/carbon
{ "require": { "nesbot/carbon": "~1.21" } }
<?php require 'vendor/autoload.php'; use Carbon\Carbon; printf("Now: %s", Carbon::now());### Without Composer
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; printf("Now: %s", Carbon::now());