PHPackages                             aminebenhariz/attendance - 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. aminebenhariz/attendance

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

aminebenhariz/attendance
========================

Attendance parser and calculator based on text input

0.4.1(10y ago)133MITPHPPHP >=5.4.0CI failing

Since Dec 16Pushed 10y ago1 watchersCompare

[ Source](https://github.com/aminebenhariz/Attendance)[ Packagist](https://packagist.org/packages/aminebenhariz/attendance)[ Docs](https://github.com/aminebenhariz/Attendance)[ RSS](/packages/aminebenhariz-attendance/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (5)Dependencies (3)Versions (6)Used By (0)

Attendance
==========

[](#attendance)

[![Build Status](https://camo.githubusercontent.com/446b68b6da84b68ae882353879d7b85b0ce617f01494b81c57da8d257029b2a1/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f616d696e6562656e686172697a2f417474656e64616e63652f6d61737465722e7376673f7374796c653d666c6174)](https://travis-ci.org/aminebenhariz/Attendance)[![Code Coverage](https://camo.githubusercontent.com/9128d6c3992d68288a7be79e40082562acc8f92ed533690aba4c9ca692ba2f0b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616d696e6562656e686172697a2f417474656e64616e63652f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/aminebenhariz/Attendance/?branch=master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/e8598dc644db474a7c3c3fd11ebdb0e43dcc9d9bb7f8432fffa70be9aeeb9e22/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f616d696e6562656e686172697a2f417474656e64616e63652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/aminebenhariz/Attendance/?branch=master)

[![SensioLabsInsight](https://camo.githubusercontent.com/398641b6a63f9e2449b0f543e0ccfecfd46d6e22065f062cafb040e6fe31015d/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f34333236323565332d323438372d346636372d393166612d3235643666643534646236372f6269672e706e67)](https://insight.sensiolabs.com/projects/432625e3-2487-4f67-91fa-25d6fd54db67)

Table of Contents
-----------------

[](#table-of-contents)

- [Install](#install)
- [Usage](#usage)
- [DayAttendanceLine Format](#dayattendanceline-format)
- [Requirements](#requirements)
- [Testing](#testing)

Install
-------

[](#install)

Via Composer

```
$ composer require aminebenhariz/attendance
```

DayAttendanceLine Format
------------------------

[](#dayattendanceline-format)

```
2015-12-12|08:30 (10:00-10:30) (16:00-16:30) 17:30

 - 2015-12-12    : date (yyyy-mm-dd)
 - 08:30         : arrival time (hh:mm)
 - (10:00-10:30) : pause from 10:00 to 10:30
 - (16:00-16:30) : pause from 16:00 to 16:30
 - 17:30         : departure time (hh:mm)

```

Description can be added like this

```
2015-12-12|08:30 (10:00-10:30) (16:00-16:30) 17:30|Some Description

```

Usage
-----

[](#usage)

### Calculate attendance

[](#calculate-attendance)

```
$dayAttendanceLine = '2015-12-12|08:30 (10:00-10:30) (16:00-16:30) 17:30';
$dayAttendance = DayAttendance::parseDayAttendanceLine($dayAttendanceLine);

echo $dayAttendance->getDuration()->format('%H:%I:%S');
// 07:30:00

echo $dayAttendance->exportLine();
// 2015-12-12|08:30 (10:00-10:15) (12:30-13:30) (16:00-16:15) 17:30
```

### Calculate average attendance of multiple days

[](#calculate-average-attendance-of-multiple-days)

```
$day1 = DayAttendance::parseDayAttendanceLine('2015-12-14|08:31 (12:02-13:42) 17:25');
$day2 = DayAttendance::parseDayAttendanceLine('2015-12-15|08:29 (12:21-13:32) (16:12-16:22) 17:24');
$day3 = DayAttendance::parseDayAttendanceLine('2015-12-16|08:52 (12:18-13:12) 17:31');
$day4 = DayAttendance::parseDayAttendanceLine('2015-12-17|08:12 (12:21-13:52) 17:24');
$day5 = DayAttendance::parseDayAttendanceLine('2015-12-18|08:35 (12:24-13:25) 17:42');

$attendance = new Attendance([$day1, $day2, $day3, $day4, $day5]);

echo $attendance->getAverage()->format('%H:%I');
// 07:40
```

Requirements
------------

[](#requirements)

The following versions of PHP are supported by this version.

- PHP 5.4
- PHP 5.5
- PHP 5.6
- PHP 7.0
- HHVM

Testing
-------

[](#testing)

```
$ composer test
```

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

 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.

###  Release Activity

Cadence

Every ~26 days

Total

5

Last Release

3745d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/121264?v=4)[Amine Ben Hariz](/maintainers/aminebenhariz)[@aminebenhariz](https://github.com/aminebenhariz)

---

Top Contributors

[![aminebenhariz](https://avatars.githubusercontent.com/u/121264?v=4)](https://github.com/aminebenhariz "aminebenhariz (81 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/aminebenhariz-attendance/health.svg)

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

###  Alternatives

[bigwhoop/sentence-breaker

Sentence boundary disambiguation (SBD) - or sentence breaking - library written in PHP.

42136.6k](/packages/bigwhoop-sentence-breaker)[linku/feedback

Abstract layer between services and output in PHP

1514.7k1](/packages/linku-feedback)

PHPackages © 2026

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