PHPackages                             minphp/date - 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. minphp/date

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

minphp/date
===========

Date Library

1.4.2(5mo ago)01.2k11MITPHPPHP >=5.3.0CI failing

Since Dec 11Pushed 5mo ago4 watchersCompare

[ Source](https://github.com/phillipsdata/minphp-date)[ Packagist](https://packagist.org/packages/minphp/date)[ Docs](http://github.com/phillipsdata/minphp-date)[ RSS](/packages/minphp-date/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (3)Versions (26)Used By (1)

Minphp/Date
===========

[](#minphpdate)

[![Build Status](https://camo.githubusercontent.com/ad499997248d25e61ceedf20729f8f7ad143a91a04869df0574822814958d0ed/68747470733a2f2f7472617669732d63692e6f72672f7068696c6c697073646174612f6d696e7068702d646174652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/phillipsdata/minphp-date) [![Coverage Status](https://camo.githubusercontent.com/0d43a14fbcfa90826315401a432d58af27dcb4728f18cd31def6a233d8822e03/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f7068696c6c697073646174612f6d696e7068702d646174652f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/phillipsdata/minphp-date?branch=master)

Date manipulation library.

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

[](#installation)

Install via composer:

```
composer require minphp/date
```

Basic Usage
-----------

[](#basic-usage)

### Instantiation

[](#instantiation)

You may optionally define custom datetime formats and from/to timezones for dates during instantiation. However, they can be defined separately when [setting timezones](#setting-timezones) or [setting datetime formats](#setting-datetime-formats).

```
use \Minphp\Date\Date;

// Define a new 'date' format to use when formatting dates via Date::cast
$formats = array('date' => 'M d, Y');

// Define timezones to use when working with dates
// The $fromTimezone is the timezone of any given date unless it contains timezone information itself
$fromTimezone = 'UTC';
// The $toTimezone is the timezone of formatted date output
$toTimezone = 'America/Los_Angeles';

$date = new Date($formats, $fromTimezone, $toTimezone);
```

### Setting Timezones

[](#setting-timezones)

Timezones can be set during instantiation or via ::setTimezone. Not setting a set of from/to timezones will use the system's defined timezone unless the given date contains timezone information.

```
use \Minphp\Date\Date;

$date = new Date();

$fromTimezone = 'UTC';
$toTimezone = 'America/Los_Angeles';

$date->setTimezone($fromTimezone, $toTimezone);
```

### Setting Datetime Formats

[](#setting-datetime-formats)

Date formats can be set on the object to simplify calls when formatting dates.

The following date formats are available by default, but can be overridden, or added to, using this method:

```
'date' => 'F j, Y'
'day' => 'l, F j, Y'
'month' => 'F Y'
'year' => 'Y'
'date_time' => 'M d y g:i:s A'

```

```
use \Minphp\Date\Date;

$date = new Date();

// Define new formats to use
$formats = array(
    'date' => 'M d, Y',
    'day' => 'd',
    'month' => 'F',
    'year' => 'y',
    'date_time' => 'M d, Y h:i A',
    'full_date' => 'c'
);

$date->setFormats($formats);
```

### Formatting a Date

[](#formatting-a-date)

Dates can be formatted by specifying your own [php date format](http://php.net/manual/en/function.date.php)or by using one of the [predefined formats](#setting-datetime-formats).

To format a date by specifying your own [date format](http://php.net/manual/en/function.date.php), use Date::format:

```
use \Minphp\Date\Date;

$date = new Date(null, 'Europe/Paris', 'Europe/Paris');

$unformattedDate = '1944-06-06T06:00:00+02:00';
$formattedDate = $date->format('M d, Y H:i', $unformattedDate); // Jun 06, 1944 06:00
```

To format a date via a [predefined format](#setting-datetime-formats) or by specifying your own [date format](http://php.net/manual/en/function.date.php), use Date::cast:

```
use \Minphp\Date\Date;

// Define new formats to use
$formats = array(
    'date' => 'M d, Y',
    'day' => 'd',
    'month' => 'F',
    'year' => 'y',
    'date_time' => 'M d, Y h:i A',
    'full_date' => 'c'
);

$date = new Date($formats, 'Europe/Paris', 'Europe/Paris');

$unformattedDate = '1944-06-06T06:00:00+02:00';
$formattedDate = $date->cast($unformattedDate); // Jun 06, 1944
$formattedDatetime = $date->cast($unformattedDate, 'date_time'); // Jun 06, 1944 06:00 AM
$formattedDay = $date->cast($unformattedDate, 'day'); // 06
$formattedYear = $date->cast($unformattedDate, 'year'); // 44
$formatted = $date->cast($unformattedDate, 'Ymd'); // 19440606
```

Formatting a date respects the set timezones:

```
use \Minphp\Date\Date;

$date = new Date(null, 'America/New_York', 'America/Los_Angeles');

// Convert date from New York to Los Angeles time
$unformattedDate = '2001-09-11 08:46:40';
$formattedDate = $date->cast($unformattedDate, 'date_time'); // Sep 11, 01 5:46:40 AM
```

### Modifying and Formatting a Date

[](#modifying-and-formatting-a-date)

A date can be modified by adding/subtracting time using the strtotime-compatible [Date and Time formats](http://php.net/manual/en/datetime.formats.php).

The date returned is also formatted according to [Formatting a Date](#formatting-a-date).

```
use \Minphp\Date\Date;

$date = new Date(null, 'America/New_York', 'Asia/Tokyo');

$unformattedDate = '1945-08-05 19:16:02';
$formattedDate = $date->modify($unformattedDate, '+3 days +3 hours -14 minutes', 'date_time'); // Aug 09, 45 11:02:02 AM
```

For dates that are modified such that they will cross daylight savings in either the from or to timezones, you should include a relative from timezone when you want to maintain a consistent time-of-day. This is necessary if your from timezone differs from the relative timezone of the date you are modifying across daylight savings.

Consider:

```
use \Minphp\Date\Date;

// Assume the from date is in UTC while we are converting to America/Los_Angeles (-8 hours standard time, or -7 hours daylight savings)
$date = new Date(null, 'UTC', 'America/Los_Angeles');

// This time represents midnight for America/Los_Angeles, but it is in UTC
// (e.g. it came from our database which stores dates in UTC even though we may display dates in America/Los_Angeles)
$time = '2016-03-01 08:00:00';

// Modifying the date across daylight savings causes the daylight savings time offset change to affect the time-of-day by adding an hour
$date->modify($time, '+1 month', 'Y-m-d H:i:s'); // 2016-04-01 01:00:00

// To maintain a consistent time-of-day despite the daylight savings time offset, pass a relative from timezone as the fourth argument to ::modify
// (this may typically be the same timezone as the to timezone)
$date->modify($time, '+1 month', 'Y-m-d H:i:s', 'America/Los_Angeles'); // 2016-04-01 00:00:00

// Similarly when daylight savings ends later in the year the offset changes the time-of-day by subtracting an hour
$date->modify('2016-10-15 07:00:00', '+1 month', 'Y-m-d H:i:s'); // 2016-11-14 23:00:00

// If a relative from timezone is set, then the time-of-day remains consistent
$date->modify('2016-10-15 07:00:00', '+1 month', 'Y-m-d H:i:s', 'America/Los_Angeles'); // 2016-11-15 00:00:00
```

Modifying dates with respect to one timezone will maintain a consistent time-of-day despite the daylight savings offset changing.

```
use \Minphp\Date\Date;

$date = new Date(null, 'America/Los_Angeles', 'America/Los_Angeles');

$newDate = $date->modify('2016-03-01 12:00:00', '+6 months', 'Y-m-d H:i:s'); // 2016-09-01 12:00:00
$date->modify($newDate, '+6 months', 'Y-m-d H:i:s'); // 2017-03-01 12:00:00
```

### Retrieving a Date Range

[](#retrieving-a-date-range)

A set of months or years can be generated. The dates are created from the current server time in the defined [from timezone](#setting-timezones).

#### Generating Months

[](#generating-months)

```
use \Minphp\Date\Date;

$date = new Date(null, 'UTC');

print_r($date->getMonths());
```

Output:

```
Array (
    [01] => January
    [02] => February
    [03] => March
    [04] => April
    [05] => May
    [06] => June
    [07] => July
    [08] => August
    [09] => September
    [10] => October
    [11] => November
    [12] => December
)
```

The month range and key/value format can be specified:

```
use \Minphp\Date\Date;

$date = new Date(null, 'UTC');

print_r($date->getMonths(2, 4, 'n', 'M'));
```

Output:

```
Array (
    [02] => Feb
    [03] => Mar
    [04] => Apr
)
```

#### Generating Years

[](#generating-years)

```
use \Minphp\Date\Date;

$date = new Date(null, 'UTC');

print_r($date->getYears(2010, 2013));
```

Output:

```
Array (
    [10] => 2010
    [11] => 2011
    [12] => 2012
    [13] => 2013
)
```

The year key/value format can be specified:

```
use \Minphp\Date\Date;

$date = new Date(null, 'UTC');

print_r($date->getYears(2010, 2013, 'Y', 'y'));
```

Output:

```
Array (
    [2010] => 10
    [2011] => 11
    [2012] => 12
    [2013] => 13
)
```

### Generating a Date Range

[](#generating-a-date-range)

A date range can be generated between two given dates, and formatted according to the given formatting rules. The dates are created from the current server time in the defined [from timezone](#setting-timezones).

The following date range formats are used by default, but can be overridden:

```
'start' => array(
    'same_day' => 'F j, Y',
    'same_month' => 'F j-',
    'same_year' => 'F j - ',
    'other' => 'F j, Y - '
),
'end' => array(
    'same_day' => '',
    'same_month' => 'j, Y',
    'same_year' => 'F j, Y',
    'other' => 'F j, Y'
)

```

```
use \Minphp\Date\Date;

$date = new Date(null, 'UTC');

$dayRange = $date->dateRange('2016-06-06', '2016-06-06')); // June 6, 2016
$monthRange = $date->dateRange('2016-06-06', '2016-06-24')); // June 6-24, 2016
$yearRange = $date->dateRange('2016-06-06', '2016-07-07')); // June 6 - July 7, 2016
$otherRange = $date->dateRange('2016-06-06', '2017-07-07')); // June 6, 2016 - July 7, 2017
```

### Retrieving a Unix Timestamp

[](#retrieving-a-unix-timestamp)

A Unix Timestamp can be retrieved from a date via [strtotime](http://php.net/manual/en/function.strtotime.php). However, the method considers the system's timezone--not the defined [from timezone](#setting-timezones)--for the timestamp conversion.

```
use \Minphp\Date\Date;

$date = new Date();

$unixDate = $date->toTime('2016-01-01T12:00:00+00:00'); // 1451649600
$unixTime = $date->toTime(1451649600); // 1451649600
```

###  Health Score

46

—

FairBetter than 92% of packages

Maintenance71

Regular maintenance activity

Popularity18

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity68

Established project with proven stability

 Bus Factor1

Top contributor holds 61% 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 ~284 days

Recently: every ~237 days

Total

14

Last Release

163d ago

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/e1100c7dbee65c40edf82c25a4b7d5a34bd677ff86263396ca2ac5163da1dbe0?d=identicon)[tysonphillips](/maintainers/tysonphillips)

![](https://www.gravatar.com/avatar/b73da57e4fcb22c7d7f459b2bd00ea7bceb6252df0cd14e2d0bf4b6a145709fc?d=identicon)[paulphillips](/maintainers/paulphillips)

---

Top Contributors

[![tysonphillips](https://avatars.githubusercontent.com/u/8607630?v=4)](https://github.com/tysonphillips "tysonphillips (25 commits)")[![JReissmueller](https://avatars.githubusercontent.com/u/18198499?v=4)](https://github.com/JReissmueller "JReissmueller (11 commits)")[![clphillips](https://avatars.githubusercontent.com/u/682986?v=4)](https://github.com/clphillips "clphillips (5 commits)")

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/minphp-date/health.svg)

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

PHPackages © 2026

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