PHPackages                             code16/carbon-business-days - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. code16/carbon-business-days

ActiveLibrary[Utility & Helpers](/categories/utility)

code16/carbon-business-days
===========================

A simple class for business days counting

v1.1.0(2y ago)54348.1k↓26.7%3MITPHPPHP ^8.0CI failing

Since Oct 8Pushed 2y ago4 watchersCompare

[ Source](https://github.com/code16/carbon-business-days)[ Packagist](https://packagist.org/packages/code16/carbon-business-days)[ RSS](/packages/code16-carbon-business-days/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

A simple business days calculator
=================================

[](#a-simple-business-days-calculator)

This package aims to count business working days between two [Carbon](https://github.com/briannesbitt/Carbon) dates.

Usage
-----

[](#usage)

```
$date = new BusinessDays();

// Set holidays (2018-1-1 is a Monday)
$date->addHoliday(Carbon::createFromDate(2018, 1, 1));

// Should return 9
$days = $date->daysBetween(
    Carbon::createFromDate(2018, 1, 1),
    Carbon::createFromDate(2018, 1, 15)
);

// Set a closed period (whole 2nd week)
$date->addClosedPeriod(
    Carbon::createFromDate(2018, 1, 8),
    Carbon::createFromDate(2018, 1, 12)
);

// Should return 5
$days = $date->daysBetween(
    Carbon::createFromDate(2018, 1, 1),
    Carbon::createFromDate(2018, 1, 15)
);
```

Default for weekend days are saturdays and sundays, but it can be configured:

```
$date->setWeekendDays([Carbon::SUNDAY, Carbon::MONDAY]);
```

You can also add or subtract days from a given date:

```
$newDate = $date->addDaysTo(
    Carbon::createFromDate(2018, 5, 14),
    10
);
$newDate = $date->subDaysFrom(
    Carbon::createFromDate(2018, 5, 14),
    10
);
```

Installation
------------

[](#installation)

```
composer require code16/carbon-business-days

```

License
-------

[](#license)

MIT

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity46

Moderate usage in the ecosystem

Community14

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 62.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1639 days

Total

2

Last Release

822d ago

PHP version history (2 changes)v1.0.0PHP >=7.0.0

v1.1.0PHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/f97dcdc942d25d5b5720b790d5f28e6accc6f05370cf5a6b52b78abc60c29e57?d=identicon)[code16](/maintainers/code16)

---

Top Contributors

[![dvlpp](https://avatars.githubusercontent.com/u/973325?v=4)](https://github.com/dvlpp "dvlpp (10 commits)")[![dniccum](https://avatars.githubusercontent.com/u/2816415?v=4)](https://github.com/dniccum "dniccum (5 commits)")[![smknstd](https://avatars.githubusercontent.com/u/2412608?v=4)](https://github.com/smknstd "smknstd (1 commits)")

---

Tags

carbonphp-library

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/code16-carbon-business-days/health.svg)

```
[![Health](https://phpackages.com/badges/code16-carbon-business-days/health.svg)](https://phpackages.com/packages/code16-carbon-business-days)
```

###  Alternatives

[illuminate/support

The Illuminate Support package.

630113.0M41.4k](/packages/illuminate-support)[spatie/holidays

Calculate public holidays

402860.1k2](/packages/spatie-holidays)[craftcms/feed-me

Import content from XML, RSS, CSV or JSON feeds into entries, categories, Craft Commerce products, and more.

293952.6k33](/packages/craftcms-feed-me)[solspace/craft-freeform

The most flexible and user-friendly form building plugin!

54681.3k19](/packages/solspace-craft-freeform)[pimcore/data-importer

Adds a comprehensive import functionality to Pimcore Datahub

46855.5k5](/packages/pimcore-data-importer)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)