PHPackages                             p-sam/duration-immutable - 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. p-sam/duration-immutable

Abandoned → [p-sam/duration-immutable](/?search=p-sam%2Fduration-immutable)ArchivedLibrary[Utility & Helpers](/categories/utility)

p-sam/duration-immutable
========================

Immutable class to store time durations

1.0.0(6y ago)17.2k↓77.8%MITPHPPHP >=7.1

Since Jan 19Pushed 6y ago1 watchersCompare

[ Source](https://github.com/p-sam/php-duration-immutable)[ Packagist](https://packagist.org/packages/p-sam/duration-immutable)[ RSS](/packages/p-sam-duration-immutable/feed)WikiDiscussions develop Synced 3w ago

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

p-sam/duration-immutable
========================

[](#p-samduration-immutable)

[![license-badge](https://camo.githubusercontent.com/048f96de8ad6892cbad75e1ef3bc71581bb32a2faaf0a4d07905f664bfa28e27/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f702d73616d2f7068702d6475726174696f6e2d696d6d757461626c652e7376673f7374796c653d666c61742d737175617265)](LICENSE) [![release-version-badge](https://camo.githubusercontent.com/9241a557e64d4304721d798fc9981aaba1006f6e7f147c2334f355b2d0dd7503/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f702d73616d2f6475726174696f6e2d696d6d757461626c652e7376673f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://packagist.org/packages/p-sam/duration-immutable) [![php-version-badge](https://camo.githubusercontent.com/75ec838fc749870851bf8d68970fba40f670c7050067ef97a2a4d4aa0b6f87c0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f702d73616d2f6475726174696f6e2d696d6d757461626c652e7376673f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/75ec838fc749870851bf8d68970fba40f670c7050067ef97a2a4d4aa0b6f87c0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f702d73616d2f6475726174696f6e2d696d6d757461626c652e7376673f7374796c653d666c61742d737175617265)

Immutable PHP class to store time durations while not being tied to a Date.

Internally uses DateInterval and DateTime to do the actual operations.

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

[](#installation)

Install with composer:

```
$ composer require p-sam/duration-immutable

```

Usage
-----

[](#usage)

### Instanciating

[](#instanciating)

```
use SP\DurationImmutable\DurationImmutable;

DurationImmutable::fromSeconds(2); // 2s
DurationImmutable::fromSeconds(-30); // - 30s
DurationImmutable::fromSeconds(92, 0.200130); // 1m 32s 200ms 130µs

DurationImmutable::fromPHPDateInterval(new DateInterval('P1DT4H')); // 1d 4H
$refDate = DateTimeImmutable::createFromFormat(DateTimeImmutable::ATOM, '2020-01-10T00:00:00+00:00');
DurationImmutable::fromPHPDateInterval(
    new DateInterval('P1M3D'),
    $refDate
); // 34d

// refer to DateInterval::createFromDateString
// for documentation on accepted formats
DurationImmutable::fromHuman('1 hour - 15 minutes'); // 45m
DurationImmutable::fromHuman('yesterday'); // - 1d
```

### Ops

[](#ops)

```
use SP\DurationImmutable\DurationImmutable;

$duration = DurationImmutable::fromHuman('120 minutes'); // 2h

$duration->abs(); // 2h
$duration->add(DurationImmutable::fromHuman('30 minutes')); // 2h 30m
$duration->sub(DurationImmutable::fromHuman('3 hours + 10 minutes')); // - 1h 10m
$duration->mul(2.5); // 5h
$duration->div(-4); // - 30m

$dateTime = new DateTimeImmutable();
$duration->addTo($dateTime); // now + 2h

$duration->toSeconds(); // 7200
$duration->toIntervalSpec(); // "PT2H"
$duration->toPHPDateInterval(); // DateInterval("PT2H")
```

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

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

Unknown

Total

1

Last Release

2358d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/17620180?v=4)[Samuel P.](/maintainers/p-sam)[@p-sam](https://github.com/p-sam)

---

Top Contributors

[![p-sam](https://avatars.githubusercontent.com/u/17620180?v=4)](https://github.com/p-sam "p-sam (4 commits)")

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/p-sam-duration-immutable/health.svg)

```
[![Health](https://phpackages.com/badges/p-sam-duration-immutable/health.svg)](https://phpackages.com/packages/p-sam-duration-immutable)
```

PHPackages © 2026

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