Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/briannesbitt/Carbon

A simple PHP API extension for DateTime.
https://github.com/briannesbitt/Carbon

Last synced: about 1 month ago
JSON representation

A simple PHP API extension for DateTime.

Host: GitHub
URL: https://github.com/briannesbitt/Carbon
Owner: briannesbitt
License: mit
Created: 2012-09-08T02:56:20.000Z (over 12 years ago)
Default Branch: master
Last Pushed: 2024-05-01T07:39:42.000Z (7 months ago)
Last Synced: 2024-05-01T12:22:42.282Z (7 months ago)
Language: PHP
Homepage: https://carbon.nesbot.com/
Size: 18 MB
Stars: 16,441
Watchers: 226
Forks: 1,280
Open Issues: 16
Metadata Files:
- Readme: readme.md
- Contributing: contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

laravel-awesome - briannesbitt/Carbon
awesome-php - Carbon - A simple DateTime API extension. (Table of Contents / Date and Time)
awesome-php-cn - Carbon - 一个简单的DateTime API扩展. (目录 / 日期和时间 Date and Time)
awesome-projects - Carbon - A simple DateTime API extension. (PHP / Date and Time)
php-awesome - Carbon - 时间日期处理类 (类库 / 时间/日期)
awesome-php - Carbon - A simple DateTime API extension. (Table of Contents / Date and Time)

README

        # Carbon

[![Latest Stable Version](https://img.shields.io/packagist/v/nesbot/carbon.svg?style=flat-square)](https://packagist.org/packages/nesbot/carbon)

[![Total Downloads](https://img.shields.io/packagist/dt/nesbot/carbon.svg?style=flat-square)](https://packagist.org/packages/nesbot/carbon)

[![GitHub Actions](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Factions-badge.atrox.dev%2Fbriannesbitt%2FCarbon%2Fbadge&style=flat-square&label=Build&logo=none)](https://github.com/briannesbitt/Carbon/actions)

[![codecov.io](https://img.shields.io/codecov/c/github/briannesbitt/Carbon.svg?style=flat-square)](https://codecov.io/github/briannesbitt/Carbon?branch=master)

An international PHP extension for DateTime. [https://carbon.nesbot.com](https://carbon.nesbot.com)

```php

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

```

```json

{

    "require": {

        "nesbot/carbon": "^3"

    }

}

```

```php



### Translators

[Thanks to people helping us to translate Carbon in so many languages](https://carbon.nesbot.com/contribute/translators/)

### Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.















































[[See all](https://carbon.nesbot.com/#sponsors)]

[[Become a sponsor via OpenCollective](https://opencollective.com/Carbon#sponsor)]





[[Become a sponsor via GitHub](https://github.com/sponsors/kylekatarnls)]

### Backers

Thank you to all our backers! 🙏



[[Become a backer](https://opencollective.com/Carbon#backer)]

## Carbon for enterprise

Available as part of the Tidelift Subscription.

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.](https://tidelift.com/subscription/pkg/packagist-nesbot-carbon?utm_source=packagist-nesbot-carbon&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)