forked from UsrSpace-Internal/website
95 lines
2.8 KiB
Markdown
95 lines
2.8 KiB
Markdown
|
# Carbon
|
||
|
|
|
||
|
|
[](https://packagist.org/packages/nesbot/carbon)
|
||
|
|
[](https://packagist.org/packages/nesbot/carbon)
|
||
|
|
[](https://travis-ci.org/briannesbitt/Carbon)
|
||
|
|
[](https://styleci.io/repos/5724990)
|
||
|
|
[](https://codecov.io/github/briannesbitt/Carbon?branch=master)
|
||
|
|
[](https://php-eye.com/package/nesbot/carbon)
|
||
|
|
[](https://github.com/phpstan/phpstan)
|
||
|
|
|
||
|
|
A simple PHP API extension for DateTime. [http://carbon.nesbot.com](http://carbon.nesbot.com)
|
||
|
|
|
||
|
|
```php
|
||
|
|
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)) {
|
||
|
|
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
|
||
|
|
```
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"require": {
|
||
|
|
"nesbot/carbon": "~1.21"
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
```php
|
||
|
|
<?php
|
||
|
|
require 'vendor/autoload.php';
|
||
|
|
|
||
|
|
use Carbon\Carbon;
|
||
|
|
|
||
|
|
printf("Now: %s", Carbon::now());
|
||
|
|
```
|
||
|
|
|
||
|
|
<a name="install-nocomposer"/>
|
||
|
|
|
||
|
|
### Without Composer
|
||
|
|
|
||
|
|
Why are you not using [composer](http://getcomposer.org/)? Download [Carbon.php](https://github.com/briannesbitt/Carbon/blob/master/src/Carbon/Carbon.php) from the repo and save the file into your project path somewhere.
|
||
|
|
|
||
|
|
```php
|
||
|
|
<?php
|
||
|
|
require 'path/to/Carbon.php';
|
||
|
|
|
||
|
|
use Carbon\Carbon;
|
||
|
|
|
||
|
|
printf("Now: %s", Carbon::now());
|
||
|
|
```
|
||
|
|
|
||
|
|
## Docs
|
||
|
|
|
||
|
|
[http://carbon.nesbot.com/docs](http://carbon.nesbot.com/docs)
|