Download the PHP package daun/datetime-carbon-format without Composer
On this page you can find all versions of the php package daun/datetime-carbon-format. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download daun/datetime-carbon-format
More information about daun/datetime-carbon-format
Files in daun/datetime-carbon-format
Package datetime-carbon-format
Short Description Format Datetime fields as Carbon instances
License MIT
Homepage https://github.com/daun/processwire-datetime-carbon-format
Informations about the package datetime-carbon-format
ProcessWire Datetime Carbon Format
Format Datetime fields as Carbon instances.
Installation
Install the module using Composer. This will install Carbon as a child dependency.
ℹ️ Installation via the module directory will only work if you already have
nesbot/carbon
required from the project root.
Usage
All Datetime fields will now be formatted as Carbon instances instead of strings. Some examples of how to make use of this:
Consult the Carbon docs for details.
Notes
Frontend only
The ProcessWire admin expects datetime fields to be strings. That's why this module will only return Carbon instances on normal frontend page views.
Date output format
When casting a Carbon instance to a string (usually when outputting the field in a template), the field's date output format will be respected.
Empty values
Empty date fields will be wrapped in a proxy object that silently "swallows" access to properties and methods without triggering an exception. That's because Carbon instances cannot be empty, i.e. created without a valid timestamp value.
Use either the timestamp
property or the isset
accessor to see if a date has a value.
carbon
API Variable
The module will create a pre-configured Carbon Factory and wire it into a new carbon
API variable. This factory object can be used to create new Carbon instances, edit settings on it, etc.
Contributing
Pull requests are welcome. Please read the Contributing Guidelines.
License
MIT