pyramid:Laravel写的分销系统

> **This file is autogenerated. Please see the [Contributing](#about-contributing) section from more information.** # Carbon [](https://packagist.org/packages/nesbot/carbon) [](https://packagist.org/packages/nesbot/carbon) [](http://travis-ci.org/briannesbitt/Carbon) A simple API extension for DateTime with PHP 5.3+ ```php 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(); ``` ## README Contents * [Installation](#install) * [Requirements](#requirements) * [With composer](#install-composer) * [Without composer](#install-nocomposer) * [API](#api) * [Instantiation](#api-instantiation) * [Testing Aids](#api-testing) * [Getters](#api-getters) * [Setters](#api-setters) * [Fluent Setters](#api-settersfluent) * [IsSet](#api-isset) * [String Formatting and Localization](#api-formatting) * [Common Formats](#api-commonformats) * [Comparison](#api-comparison) * [Addition and Subtraction](#api-addsub) * [Difference](#api-difference) * [Difference for Humans](#api-humandiff) * [Modifiers](#api-modifiers) * [Constants](#api-constants) * [About](#about) * [Contributing](#about-contributing) * [Author](#about-author) * [License](#about-license) * [History](#about-history) * [Why the name Carbon?](#about-whyname) <a name="install"/> ## Installation <a name="requirements"/> ### Requirements - Any flavour of PHP 5.3+ should do - [optional] PHPUnit to execute the test suite <a name="install-composer"/> ### With Composer The easiest way to install Carbon is via [composer](http://getcomposer.org/). Create the following `composer.json` file and run the `php composer.phar install` command to install it. ```json { "require": { "nesbot/Carbon": "*" } } ``` ```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()); ``` <a name="api"/> ## API The Carbon class is [inherited](http://php.net/manual/en/keyword.extends.php) from the PHP [DateTime](http://www.php.net/manual/en/class.datetime.php) class. ```php <?php class Carbon extends \DateTime { // code here } ``` Carbon has all of the functions inherited from the base DateTime class. This approach allows you to access the base functionality if you see anything missing in Carbon but is there in DateTime. > **Note: I live in Ottawa, Ontario, Canada and if the timezone is not specified in the examples then the default of 'America/Toronto' is to be assumed. Typically Ottawa is -0500 but when daylight savings time is on we are -0400.** Special care has been taken to ensure timezones are handled correctly, and where appropriate are based on the underlying DateTime implementation. For example all comparisons are done in UTC or in the timezone of the datetime being used. ```php $dtToronto = Carbon::createFromDate(2012, 1, 1, 'America/Toronto'); $dtVancouver = Carbon::createFromDate(2012, 1, 1, 'America/Vancouver'); echo $dtVancouver->diffInHours($dtToronto); // 3 ``` Also `is` comparisons are done in the timezone of the provided Carbon instance. For example my current timezone is -13 hours from Tokyo. So `Carbon::now('Asia/Tokyo')->isToday()` would only return false for any time past 1 PM my time. This doesn't make sense since `now()` in tokyo is always today in Tokyo. Thus the comparison to `now()` is done in the same timezone as the current instance. <a name="api-instantiation"/> ### Instantiation There are several different methods available to create a new instance of Carbon. First there is a constructor. It overrides the [parent constructor](http://www.php.net/manual/en/datetime.construct.php) and you are best to read about the first parameter from the PHP manual and understand the date/time string formats it accepts. You'll hopefully find yourself rarely using the constructor but rather relying on the explicit static methods for improved readability. ```php $carbon = new Carbon(); // equivalent to Carbon::now() $carbon = new Carbon('first day of January 2008', 'America/Vancouver'); echo get_class($carbon); // 'Carbon\Carbon' ``` You'll notice above that the timezone (2nd) parameter was passed as a string rather than a `\DateTimeZone` instance. All DateTimeZone parameters have been augmented so you can pass a DateTimeZone instance or a string and the timezone will be created for you. This is again shown in the next example which also introduces the `now()` function. ```php $now = Carbon::now(); $nowInLondonTz = Carbon::now(new DateTimeZone('Europe/London')); // or just pass the timezone as a string $nowInLondonTz = Carbon::now('Europe/London'); ``` If you really love your fluid method calls and get frustrated by the extra line or ugly pair of brackets necessary when using the constructor you'll enjoy the `parse` method. ```php echo (new Carbon('first day of December 2008'))->addWeeks(2); // 2008-12-15 00:00:00 echo Carbon::parse('first day of December 2008')->addWeeks(2); // 2008-12-15 00:00:00 ``` To accompany `now()`, a few other static instantiation helpers exist to create widely known instances. The only thing to really notice here is that `today()`, `tomorrow()` and `yesterday()`, besides behaving as expected, all accept a timezone parameter and each has their time value set to `00:00:00`. ```php $now = Carbon::now(); echo $now; // 2014-09-24 23:55:55 $today = Carbon::today(); echo $today; // 2014-09-24 00:00:00 $tomorrow = Carbon::tomorrow('Europe/London'); echo $tomorrow; // 2014-09-26 00:00:00 $yesterday = Carbon::yesterday(); echo $yesterday; // 2014-09-23 00:00:00 ``` The next group of static helpers are the `createXXX()` helpers. Most of the static `create` functions allow you to provide as many or as few arguments as you want and will provide default values for all others. Generally default values are the current date, time or timezone. Higher values will wrap appropriately but invalid values will throw an `InvalidArgumentException` with an informative message. The message is obtained from an [DateTime::getLastErrors()](http://php.net/manual/en/datetime.getlasterrors.php) call. ```php Carbon::createFromDate($year, $month, $day, $tz); Carbon::createFromTime($hour, $minute,