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

ActiveKirby-plugin[Utility & Helpers](/categories/utility)

adspectus/date-extended
=======================

Plugin to provide two additional date fields which will store the creation date and the modication date as a Unix Epoch. A field method is provided to convert this epoch to a formatted string.

1.1.3(5y ago)9912↓50%2[1 PRs](https://github.com/Adspectus/k3-date-extended/pulls)GPL-3.0-or-laterPHP

Since Jun 22Pushed 5y ago2 watchersCompare

[ Source](https://github.com/Adspectus/k3-date-extended)[ Packagist](https://packagist.org/packages/adspectus/date-extended)[ RSS](/packages/adspectus-date-extended/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (1)Versions (6)Used By (0)

k3-date-extended
----------------

[](#k3-date-extended)

[![GitHub tag (latest by date)](https://camo.githubusercontent.com/d432a8097c136eff91be707995da2cd84d11a0590de7d58218c5d4110af06537/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f7461672f4164737065637475732f6b332d646174652d657874656e6465643f7374796c653d666c61742d737175617265266c6162656c3d56657273696f6e)](https://github.com/Adspectus/k3-date-extended/releases)[![GitHub issues](https://camo.githubusercontent.com/6c3c5659817b9b667ac69a6d6078db037d03cac25a31b88b441316413c076b59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f4164737065637475732f6b332d646174652d657874656e6465643f7374796c653d666c61742d737175617265266c6162656c3d497373756573)](https://github.com/Adspectus/k3-date-extended/issues)[![GitHub license](https://camo.githubusercontent.com/9f63b9c7c1daf87c8875ff0c3d333431296a4f844fa385640b585c2b8081721e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f4164737065637475732f6b332d646174652d657874656e6465643f7374796c653d666c61742d737175617265266c6162656c3d4c6963656e7365)](https://github.com/Adspectus/k3-date-extended/blob/master/LICENSE)[![Kirby version](https://camo.githubusercontent.com/aceac14a01f6563b1b4396064dc7239357de8ceada9234caec9d8f8f22299dd1/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d4b69726279266d6573736167653d3326636f6c6f723d79656c6c6f77267374796c653d666c61742d737175617265)](https://getkirby.com/)

Kirby 3 plugin to provide additional date fields as epoch.

The rationale to use the epoch, which is the number of seconds starting from Jan. 1, 1970 0:00 GMT as a date/time field, is to have an universally valid piece of information about the date and time from which one can derive all other kind of information, i.e. the same point in time in different timezones. Moreover, it is easier to calculate or compare different dates or points in time using the epoch. The drawback is that it is not very human-friendly to read and write. However, there shouldn't be any serious programming or scripting language which does not contain built-in functions to convert back and forth between the epoch and a human-friendly date and time.

The epoch as it is written by the `time()` function used here, always refers to GMT, which can be used as being the same time as UTC, even though GMT and UTC are not the same. Thus, the value of the epoch is independent from the timezone setting in your `php.ini` file, but the formatted date as returned by the `date()` function will take that into account.

Getting Started
---------------

[](#getting-started)

### Prerequisites

[](#prerequisites)

- Kirby 3

### Installation

[](#installation)

You can install this plugin via one of the following methods:

1. Composer

    ```
    composer require adspectus/date-extended

    ```
2. Manual

    Clone this repository or download the current release and extract the file `index.php` into a new folder `site/plugins/date-extended` of your Kirby installation.

Usage
-----

[](#usage)

This plugin uses the `page.create:after` hook to store 2 additional fields into the page, the creation and modification date/time as a Unix Epoch. With the `page.update:after` and the `page.changeTitle:after` hooks only the modification date is updated.

In addition to that, the plugin provides a field method `epoch2date` to return this epoch in a formatted string. The default format of this string is set to `D, j M Y H:i:s T`, but this can be changed on a global level in site-config with

```
'adspectus.date-extended.dateFormat' => string or constant

```

or as a parameter to the field method.

The fieldnames can be set with

```
'adspectus.date-extended.dateCreated' => 'myCreationDate',
'adspectus.date-extended.dateModified' => 'myModificationDate',

```

Otherwise they default to `dateCreatedEpoch` and `dateModifiedEpoch` resp.

Examples
--------

[](#examples)

After installation of this plugin, when you create and afterwards change (text or title) a page, you will have these fields in your content file:

```
----

Datecreatedepoch: 1592831460

----

Datemodifiedepoch: 1592831953

----

```

Then, you can use this in your blueprint:

```
    fields:
      date_created_info:
        type: info
        label:
          en: Creation Date
          de: Erstellungsdatum
        theme: none
        text: "{{ page.dateCreatedEpoch.epoch2date }}"
      date_modified_info:
        type: info
        label:
          en: Last Modification
          de: Letzte Aktualisierung
        theme: none
        text: "{{ page.dateModifiedEpoch.epoch2date('c') }}"

```

and in the panel it will look like this:

[![Screenshot Panel](panel01.png)](panel01.png)

License
-------

[](#license)

[GNU General Public License v3.0](LICENSE)

Acknowledgements
----------------

[](#acknowledgements)

- [texnixe](https://forum.getkirby.com/u/texnixe/) for the basic stuff

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

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

Every ~0 days

Total

5

Last Release

2155d ago

### Community

Maintainers

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

---

Top Contributors

[![Adspectus](https://avatars.githubusercontent.com/u/8707493?v=4)](https://github.com/Adspectus "Adspectus (12 commits)")

### Embed Badge

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

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

###  Alternatives

[distantnative/retour-for-kirby

Manage redirects and track 404s right from the Kirby CMS Panel

14689.4k1](/packages/distantnative-retour-for-kirby)[mzur/kirby-uniform

A versatile Kirby plugin to handle web form actions.

26068.3k13](/packages/mzur-kirby-uniform)[arnoson/kirby-vite

Vite helper for Kirby CMS

9759.2k3](/packages/arnoson-kirby-vite)[thathoff/kirby-git-content

Plugin to track changes to content in a git repository.

15343.7k](/packages/thathoff-kirby-git-content)[sylvainjule/locator

A map & geolocation field, built on top of open-source services / Mapbox

11237.3k1](/packages/sylvainjule-locator)[tobimori/kirby-seo

The default choice for SEO on Kirby: Implement technical SEO & Meta best practices with ease and provide an easy-to-use editor experience

10039.7k1](/packages/tobimori-kirby-seo)

PHPackages © 2026

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