PHPackages                             lullabot/jornada - 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. lullabot/jornada

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

lullabot/jornada
================

A library for calculating working days for teams

01PHP

Since Dec 7Pushed 5y ago4 watchersCompare

[ Source](https://github.com/Lullabot/jornada)[ Packagist](https://packagist.org/packages/lullabot/jornada)[ RSS](/packages/lullabot-jornada/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Jornada
=======

[](#jornada)

*A PHP library and CLI tool to calculate your team's working days*

Example
-------

[](#example)

```
$ bin/console help member:report
Description:
  Generate a report of working days for team members

Usage:
  member:report [options] [--]

Arguments:
  end-date                       The end date to calculate the report to, in YYYY-MM-DD format.
  people                         A list of people on the project, one per line.

Options:
  -b, --booked-pto[=BOOKED-PTO]  Path to booked PTO CSV with columns ,. [default: ""]
  -o, --owed-pto[=OWED-PTO]      Path to owed PTO CSV with columns ,,. [default: ""]
  -s, --start-date=START-DATE    The start date to calculate the report from, in YYYY-MM-DD format. [default: "2020-12-02"]
  -h, --help                     Display this help message
  -q, --quiet                    Do not output any message
  -V, --version                  Display this application version
      --ansi                     Force ANSI output
      --no-ansi                  Disable ANSI output
  -n, --no-interaction           Do not ask any interactive question
  -v|vv|vvv, --verbose           Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

$ bin/console member:report --start-date=2020-11-30 2020-12-31 tests/fixtures/csv/multiple/people.csv
Team business days: 96
andrew has 24 business days remaining, 24 working days remaining, finishing on 2020-12-31.
amanda has 24 business days remaining, 24 working days remaining, finishing on 2020-12-31.
harry has 24 business days remaining, 24 working days remaining, finishing on 2020-12-31.
zoe has 24 business days remaining, 24 working days remaining, finishing on 2020-12-31.
Total team working days: 96

$ bin/console member:report --start-date=2020-11-30 2020-12-31 --booked-pto=tests/fixtures/csv/multiple/booked-pto.csv tests/fixtures/csv/multiple/people.csv
Team business days: 96
andrew has 24 business days remaining, 23 working days remaining, finishing on 2020-12-31.
amanda has 24 business days remaining, 21 working days remaining, finishing on 2020-12-31.
harry has 24 business days remaining, 23 working days remaining, finishing on 2020-12-31.
zoe has 24 business days remaining, 23 working days remaining, finishing on 2020-12-30.
Total team working days: 90

$ bin/console member:report --start-date=2020-11-30 2020-12-31 --booked-pto=tests/fixtures/csv/multiple/booked-pto.csv --owed-pto=tests/fixtures/csv/multiple/owed-pto.csv tests/fixtures/csv/multiple/people.csv
Team business days: 96
andrew has 24 business days remaining, 22 working days remaining, finishing on 2020-12-30.
amanda has 24 business days remaining, 19 working days remaining, finishing on 2020-12-29.
harry has 24 business days remaining, 20 working days remaining, finishing on 2020-12-25.
zoe has 24 business days remaining, 19 working days remaining, finishing on 2020-12-25.
Total team working days: 80
```

Key APIs
--------

[](#key-apis)

- [WorkingDaysCalculator](src/WorkingDaysCalculator.php) supports calculating business days, working days, and end dates for arbitrary ranges of dates based on existing and future holiday plans.
- [TeamCalculator](src/TeamCalculator.php) supports grouping multiple WorkingDaysCalculators together, and then calculating results for an entire team.

###  Health Score

16

—

LowBetter than 5% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity1

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity31

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/7f2b22c5ce2b0ee6b619c41efe1ddb93ac84d910f59539363009b76810469c72?d=identicon)[lullabot](/maintainers/lullabot)

---

Top Contributors

[![deviantintegral](https://avatars.githubusercontent.com/u/255023?v=4)](https://github.com/deviantintegral "deviantintegral (24 commits)")

### Embed Badge

![Health badge](/badges/lullabot-jornada/health.svg)

```
[![Health](https://phpackages.com/badges/lullabot-jornada/health.svg)](https://phpackages.com/packages/lullabot-jornada)
```

PHPackages © 2026

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