PHPackages                             duncan3dc/dates - 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. duncan3dc/dates

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

duncan3dc/dates
===============

A simple library for working with dates and ranges using the default timezone

2.0.0(1y ago)0215Apache-2.0PHPPHP ^8.0CI passing

Since Jan 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/duncan3dc/dates)[ Packagist](https://packagist.org/packages/duncan3dc/dates)[ Docs](https://github.com/duncan3dc/dates)[ RSS](/packages/duncan3dc-dates/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (31)Used By (0)

dates
=====

[](#dates)

A simple library for working with dates and ranges using the default timezone

Full documentation is available at
PHPDoc API documentation is also available at [http://duncan3dc.github.io/dates/api/](http://duncan3dc.github.io/dates/api/namespaces/duncan3dc.Laravel.html)

[![release](https://camo.githubusercontent.com/4c9b58c8552ce81c7f5efca00e9a62f6777cabbd35f40c9d5398720060abc114/68747470733a2f2f706f7365722e707567782e6f72672f64756e63616e3364632f64617465732f76657273696f6e2e737667)](https://packagist.org/packages/duncan3dc/dates)[![build](https://github.com/duncan3dc/dates/workflows/.github/workflows/buildcheck.yml/badge.svg?branch=main))](https://github.com/duncan3dc/dates/actions/workflows/coverage.yml)[![coverage](https://camo.githubusercontent.com/ea50ec6d249427887d6d2ebfe02eec0ede4b8a4f548f1d38af55ec5022c3ca27/68747470733a2f2f636f6465636f762e696f2f67682f64756e63616e3364632f64617465732f67726170682f62616467652e737667)](https://codecov.io/gh/duncan3dc/dates)

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

[](#installation)

The recommended method of installing this library is via [Composer](//getcomposer.org/).

Run the following command from your project root:

```
$ composer require duncan3dc/dates
```

Changelog
---------

[](#changelog)

A [Changelog](CHANGELOG.md) has been available since version 1.2.0

Where to get help
-----------------

[](#where-to-get-help)

Found a bug? Got a question? Just not sure how something works?
Please [create an issue](//github.com/duncan3dc/dates/issues) and I'll do my best to help out.
Alternatively you can catch me on [Twitter](https://twitter.com/duncan3dc)

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance44

Moderate activity, may be stable

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity79

Established project with proven stability

 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 ~137 days

Recently: every ~695 days

Total

28

Last Release

438d ago

Major Versions

0.7.1 → 1.0.02015-05-25

0.9.1 → 1.1.02016-04-13

1.4.0 → 2.0.x-dev2025-03-06

PHP version history (6 changes)0.1.0PHP >=5.4.0

0.5.0PHP >=5.5.0

0.7.7PHP >=5.6.0

1.2.0PHP ^5.6|^7.0

1.4.0PHP ^7.2 || ^8.0

2.0.x-devPHP ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/11dc66042513f11d1c99b1e6763f25dca84a3ff31cdbea3972b9b804a3d3d5e9?d=identicon)[duncan3dc](/maintainers/duncan3dc)

---

Top Contributors

[![duncan3dc](https://avatars.githubusercontent.com/u/546811?v=4)](https://github.com/duncan3dc "duncan3dc (98 commits)")

---

Tags

datedatetimephpdateparseparsingformatting

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/duncan3dc-dates/health.svg)

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

###  Alternatives

[rlanvin/php-rrule

Lightweight and fast recurrence rules for PHP (RFC 5545)

69810.6M39](/packages/rlanvin-php-rrule)[knplabs/knp-time-bundle

Making your dates and durations look sensible and descriptive

6308.9M39](/packages/knplabs-knp-time-bundle)[aeon-php/calendar

PHP type safe, immutable calendar library

2079.7M16](/packages/aeon-php-calendar)[enqueue/dsn

Parse DSN

12525.5M45](/packages/enqueue-dsn)[lawondyss/moment-php

MomentPHP is library for parsing, manipulating and formatting dates.

1418.4k](/packages/lawondyss-moment-php)

PHPackages © 2026

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