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

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

ivandelabeldad/dates
====================

Basic Dates library for PHP

2.1.1(8y ago)1501MITPHP

Since Oct 24Pushed 8y agoCompare

[ Source](https://github.com/ivandelabeldad/php-dates)[ Packagist](https://packagist.org/packages/ivandelabeldad/dates)[ RSS](/packages/ivandelabeldad-dates/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (1)Versions (12)Used By (1)

PHP Dates
=========

[](#php-dates)

[![Packagist](https://camo.githubusercontent.com/b162c774c082ad20a0d3f86f2eb5ed028ccb93d35c96c729ee65019f84c6c5a1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6976616e64656c6162656c6461642f64617465732e737667)](https://packagist.org/packages/ivandelabeldad/dates)[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://github.com/ivandelabeldad/api-rackian/blob/master/LICENSE)

Basic Dates library for PHP

Install
-------

[](#install)

```
composer require ivandelabeldad/dates

```

Usage
-----

[](#usage)

### Date, Time, and DateTime

[](#date-time-and-datetime)

```
// Time only have hour, minute and seconds
$time = Time::now();

// Date have year, month, day, season and day of week
$date = Date::now();

// DateTime have date attributes and time either
$dateTime = DateTime::now();
```

### Create a Date, Time or DateTime

[](#create-a-date-time-or-datetime)

```
// FROM YEAR-MONTH-DAY HOUR-MINUTE-SECOND
$time       = Time::create(12, 45, 0);
$date       = Date::create(1999, 12, 31);
$dateTime   = DateTime::create(1999, 12, 31, 12, 45, 0);

// FROM CURRENT TIME
$time       = Time::now();
$date       = Date::now();
$dateTime   = DateTime::now();

// FROM TIME IN SECONDS (UNIX TIME)
$time       = Time::fromUnixTime(time());
$date       = Date::fromUnixTime(time());
$dateTime   = DateTime::fromUnixTime(time());
```

### Get a Date range (Only Dates)

[](#get-a-date-range-only-dates)

```
$startDate = Date::create(2000, 1, 1);
$endDate = Date::create(2000, 12, 31);

// Contains every day of the year 2000
$dates = DateUtils::datesBetween($startDate, $endDate);
```

### DateLists usage

[](#datelists-usage)

```
$list = new DateArrayList();

// ADD ONE DATE
$list->add(Date::now());

// ADD MULTIPLE DATES
$list->addAll([
    $date1,
    $date2,
    $date3,
]);

// RETURN 4
$list->size();

// REMOVE FIRST DATE AND MOVE OTHERS TO THE BEGINNING
$list->remove(0);
```

### Sorting using lists

[](#sorting-using-lists)

```
// DATES SORTED FROM BEFORE TO AFTER
$list->sort(new DateNaturalComparator());

// DATES SORTED FROM AFTER TO BEFORE
$list->sort(new DateNaturalComparator(), false);
```

### Example of filtering usage

[](#example-of-filtering-usage)

```
// Get only weekends in summer and spring
$filtered = DateFilter::builder($listOfDates)
	->filterBySeasons([Season::SUMMER, Season::SPRING])
   	->filterByDaysOfWeek([DayOfWeek::SATURDAY, DayOfWeek::SUNDAY])
    ->build();
```

License
-------

[](#license)

The API Rackian is open-sourced software licensed under the [MIT LICENSE](https://github.com/ivandelabeldad/php-dates/blob/master/LICENSE)

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity70

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

Total

11

Last Release

3123d ago

Major Versions

1.2.2 → 2.0.02017-10-25

### Community

Maintainers

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

---

Top Contributors

[![ivanbeldad](https://avatars.githubusercontent.com/u/10326536?v=4)](https://github.com/ivanbeldad "ivanbeldad (33 commits)")

### Embed Badge

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

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

###  Alternatives

[schmeits/filament-4-phosphor-icons

This is my package filament-4-phosphor-icons

172.7k](/packages/schmeits-filament-4-phosphor-icons)

PHPackages © 2026

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