mareg/rough-date

Rough date object allowing dates like `Jan 2005` or `2006`

Rough Date

Needed to store a "rough date" in one of my project, may be useful for otheres., _(*1)

, _(*2)

Installation

Execute from shell the following command:, _(*3)

$ composer require mareg/rough-date

Or add "mareg/rough-date": "^1.0" to your composer.json:, _(*4)

    "require": {
        "mareg/rough-date": "^1.0"
    },

Usage

Create a RoughDate object from the string:, _(*5)

$roughDate = RoughDate::fromString('May 2005');
echo $roughDate->format();

Or from a DateTime date object:, _(*6)

$date = new \DateTime();
$roughDate = RoughDate::fromDateTime($date);
echo $roughDate->format();

Accepted date formats

When creating an object through RoughDate::fromString():, _(*7)

• Y-m-d, e.g. 2015-02-22, but also 2013-05-00 and 2013-00-00 are correct
• Y/m/d and Y.m.d are accepted
• j. M Y, e.g. 13. May 2005
• M Y, e.g. May 1985
• Y, e.g. 1978

Output date formats

When calling RoughDate::format(): * For a full date output accepts all variables as in date() method * For other dates only available variables will be substituded and unavailable ones will be removed, e.g.: * for date 2015-02-00 and format j M Y you'll get Feb 2015 * for date 1978-00-00 and format j M Y you'll get 1978, _(*8)