PHPackages                             ivandokov/fluentdate - 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. ivandokov/fluentdate

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

ivandokov/fluentdate
====================

Library to format PHP dates

1.0.0(5y ago)1652MITPHPPHP ^7.4.0

Since Oct 13Pushed 5y ago1 watchersCompare

[ Source](https://github.com/ivandokov/fluentdate)[ Packagist](https://packagist.org/packages/ivandokov/fluentdate)[ RSS](/packages/ivandokov-fluentdate/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (2)Used By (0)

FluentDate
==========

[](#fluentdate)

[![Tests Action Status](https://github.com/ivandokov/fluentdate/workflows/Tests/badge.svg)](https://github.com/ivandokov/fluentdate/actions)[![Packagist PHP Version Support](https://camo.githubusercontent.com/2f222a952cc9ffad2f59c3b84338509b196727b6f38d8929c1c96e01da69e720/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6976616e646f6b6f762f666c75656e7464617465)](https://packagist.org/packages/ivandokov/fluentdate)[![Packagist Version](https://camo.githubusercontent.com/83e85e63d587303f72f896d7ecb4df9f1e7604e3c0981e31fe1defd7110b3654/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6976616e646f6b6f762f666c75656e7464617465)](https://packagist.org/packages/ivandokov/fluentdate)[![Packagist Downloads](https://camo.githubusercontent.com/7a87e5970928601ccc3eb9de16b1517ae1662468bb355fcd77cfc826128cfcec/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6976616e646f6b6f762f666c75656e7464617465)](https://packagist.org/packages/ivandokov/fluentdate)[![Packagist License](https://camo.githubusercontent.com/072ae2a359a23d9c1c15f68a1d4e7131b2138880b33b533f2551d1320ac9cca1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6976616e646f6b6f762f666c75656e7464617465)](https://packagist.org/packages/ivandokov/fluentdate)

Format PHP dates with ease. You don't have to Google the [format](https://www.php.net/manual/en/datetime.format.php) string each time. Use plain English to set the format, almost as you pronounce it.

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

[](#installation)

```
composer require ivandokov/fluentdate
```

How to use
----------

[](#how-to-use)

For full details of how to use the library please take a look at our [tests](tests/FluentDateTest.php).

### Format string

[](#format-string)

Any string that can be parsed by `DateTime` class can be used.

```
$date = FluentDate::forString('now')
    ->year(new YearFourDigits())
    ->separator(new SeparatorDot())
    ->month(new MonthTwoDigitsWithLeadingZeros())
    ->separator(new SeparatorDot())
    ->day(new DayWithLeadingZero());

echo "Today is $date";
//    Today is 2020.10.09
```

### Format DateTime

[](#format-datetime)

```
$datetime = new DateTime('now'); // The DateTime you want to format
$date = FluentDate::forDateTime($datetime)
    ->year(new YearFourDigits())
    ->separator(new SeparatorDot())
    ->month(new MonthTwoDigitsWithLeadingZeros())
    ->separator(new SeparatorDot())
    ->day(new DayWithLeadingZero());

echo "Today is $date";
//    Today is 2020.10.09
```

The `$date` can be directly used in strings since it implements `__toString()` magic method but if you want you can use the `->toString()` method.

### The format string

[](#the-format-string)

If you want to get the underlying date format string you can use the `->toFormat()` method like this:

```
$datetime = new DateTime('01.03.2020 00:00:00');
$dateFormat = FluentDate::forDateTime($datetime)
    ->year(new YearFourDigits())
    ->separator(new SeparatorDot())
    ->month(new MonthTwoDigitsWithLeadingZeros())
    ->separator(new SeparatorDot())
    ->day(new DayWithLeadingZero())
    ->toFormat();
// Y.m.d
```

### Format Carbon

[](#format-carbon)

If you want to format a [Carbon](https://carbon.nesbot.com/) instance you can use the same method described above since Carbon is extending `DateTime`.

```
$carbon = Carbon::now();
$date = FluentDate::forDateTime($carbon)
    ->year(new YearFourDigits())
    ->separator(new SeparatorDot())
    ->month(new MonthTwoDigitsWithLeadingZeros())
    ->separator(new SeparatorDot())
    ->day(new DayWithLeadingZero())
    ->toString();
// 2020.10.09
```

Available formats
-----------------

[](#available-formats)

The format classes are self explanatory by their class names so you can take a look at all available classes in the [Formats](src/Formats) directory.

Separators
----------

[](#separators)

We support the most common separators for dates but also a custom string separator in case of need.

- `IvanDokov\FluentDate\Formats\SeparatorDot`
- `IvanDokov\FluentDate\Formats\SeparatorDash`
- `IvanDokov\FluentDate\Formats\SeparatorForwardSlash`
- `IvanDokov\FluentDate\Formats\SeparatorSpace`
- `IvanDokov\FluentDate\Formats\SeparatorColon`
- `IvanDokov\FluentDate\Formats\SeparatorString`

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity54

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

2034d ago

### Community

Maintainers

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

---

Top Contributors

[![ivandokov](https://avatars.githubusercontent.com/u/2357455?v=4)](https://github.com/ivandokov "ivandokov (14 commits)")

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/ivandokov-fluentdate/health.svg)

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

###  Alternatives

[michael-rubel/laravel-couponables

This package provides polymorphic coupon functionality for your Laravel application.

19590.7k1](/packages/michael-rubel-laravel-couponables)[loadsys/cakephp_sitemap

A CakePHP Plugin for adding automatic XML and HTML Sitemaps to an app

2819.6k](/packages/loadsys-cakephp-sitemap)[mauricerenck/komments

A comment and webmention plugin for Kirby 3

501.2k1](/packages/mauricerenck-komments)[myweb/show-out-of-stock-products

Show out-of-stock product configurations for configurable products on the front end.

131.7k](/packages/myweb-show-out-of-stock-products)

PHPackages © 2026

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