nesbot/carbon

A simple API extension for DateTime.

Friday, July 27, 2018
by Brian Nesbitt
Repository
253 Watchers
9674 Stars
52,645,964 Installations

PHP
1838 Dependents
32 Suggesters
970 Forks
2 Open issues
63 Versions
9 % Grown

The README.md

Carbon

, _(*1)

An international PHP extension for DateTime. https://carbon.nesbot.com, _(*2)

<?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();

$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!';
}
// Over 200 languages (and over 500 regional variants) supported:
echo Carbon::now()->subMinutes(2)->diffForHumans(); // '2 minutes ago'
echo Carbon::now()->subMinutes(2)->locale('zh_CN')->diffForHumans(); // '2分钟前'
echo Carbon::parse('2019-07-23 14:51')->isoFormat('LLLL'); // 'Tuesday, July 23, 2019 2:51 PM'
echo Carbon::parse('2019-07-23 14:51')->locale('fr_FR')->isoFormat('LLLL'); // 'mardi 23 juillet 2019 14:51'

// ... but also does 'from now', 'after' and 'before'
// rolling up to seconds, minutes, hours, days, months, years

$daysSinceEpoch = Carbon::createFromTimestamp(0)->diffInDays(); // something such as:
                                                                // 19817.6771
$daysUntilInternetBlowUp = $internetWillBlowUpOn->diffInDays(); // Negative value since it's in the future:
                                                                // -5037.4560

// Without parameter, difference is calculated from now, but doing $a->diff($b)
// it will count time from $a to $b.
Carbon::createFromTimestamp(0)->diffInDays($internetWillBlowUpOn); // 24855.1348

Installation

With Composer

$ composer require nesbot/carbon

{
    "require": {
        "nesbot/carbon": "^3"
    }
}

<?php
require 'vendor/autoload.php';

use Carbon\Carbon;

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

Without Composer

Why are you not using composer? Download the Carbon latest release and put the contents of the ZIP archive into a directory in your project. Then require the file autoload.php to get all classes and dependencies loaded on need., _(*3)

<?php
require 'path-to-Carbon-directory/autoload.php';

use Carbon\Carbon;

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

Documentation

https://carbon.nesbot.com/docs, _(*4)

⚠️ Documentation is being updated to reflect behavior on the version 3 See the migration section listing the main differences between Carbon 2 and Carbon 3, _(*5)

If you see a section referring to Carbon 2 behavior outside this section or have any doubt about other documentation part, do not hesitate to open an issue to raise it., _(*6)

Security contact information

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure., _(*7)

Credits

Contributors

This project exists thanks to all the people who contribute., _(*8)

, _(*9)

Translators

Thanks to people helping us to translate Carbon in so many languages, _(*10)

Backers

Thank you to all our backers! 🙏, _(*16)

, _(*17)

[Become a backer], _(*18)

Carbon for enterprise

Available as part of the Tidelift Subscription., _(*19)

The maintainers of Carbon and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more., _(*20)

The Versions

27/07 2018

dev-master

9999999-dev http://carbon.nesbot.com

A simple API extension for DateTime.

library carbon

A simple API extension for DateTime.

nesbot/carbon

The README.md

Carbon

Installation

With Composer

Without Composer

Documentation

Security contact information

Credits

Contributors

Translators

Sponsors

Backers

Carbon for enterprise

The Versions

dev-master

The Requires

The Development Requires

by Brian Nesbitt

dev-version-2.0

The Requires

The Development Requires

by Brian Nesbitt

dev-version-1.next

The Requires

The Development Requires

by Brian Nesbitt

dev-version-1.32

The Requires

The Development Requires

by Brian Nesbitt

1.32.0

The Requires

The Development Requires

by Brian Nesbitt

dev-version-1.31

The Requires

The Development Requires

by Brian Nesbitt

1.31.1

The Requires

The Development Requires

by Brian Nesbitt

1.31.0

The Requires

The Development Requires

by Brian Nesbitt

dev-laravel-locale-sync

The Requires

The Development Requires

by Brian Nesbitt

dev-version-1.30

The Requires

The Development Requires

by Brian Nesbitt

1.30.0

The Requires

The Development Requires

by Brian Nesbitt

dev-version-1.29

The Requires

The Development Requires

by Brian Nesbitt

1.29.2

The Requires

The Development Requires

by Brian Nesbitt

dev-analysis-qxakvB

The Requires

The Development Requires

by Brian Nesbitt

dev-pull-request-914

The Requires

The Development Requires

by Brian Nesbitt

1.29.1

The Requires

The Development Requires