This Field Type represents a full date including time information.
| Name | Internal name | Expected input type |
|---|
DateAndTime | ezdatetime | mixed |
Description
This Field Type makes possible to store and retrieve a full date including time information.
PHP API Field Type
If input value is of type string or integer, it will be passed directly to the PHP's built-in \DateTime class constructor, therefore the same input format expectations apply.
It is also possible to directly pass an instance of \DateTime.
| Type | Example |
|---|
string | "2012-08-28 12:20 Europe/Berlin" |
integer | 1346149200 |
\DateTime | new \DateTime() |
Value object
Properties
The Value class of this field type contains the following properties:
| Property | Type | Description |
|---|
$value | \DateTime | The date and time value as an instance of \DateTime. |
Constructor
The constructor for this value object will initialize a new Value object with the value provided. It accepts an instance of PHP's built-in \DateTime class.
String representation
String representation of the date value will generate the date string in the format "D Y-d-m H:i:s" as accepted by PHP's built-in date() function.
Example:
Wed 2013-22-05 12:19:18
Hash value of this Field Type is an array with two keys:
| Key | Type | Description | Example |
|---|
timestamp
| integer | Time information as a timestamp. | 1400856992
|
rfc850
| string | Time information as a string in RFC 850 date format. As input, this will have higher precedence over the timestamp value. | "Friday, 23-May-14 14:56:14 GMT+0000" |
Validation
This Field Type does not perform any special validation of the input value.
Settings
The field definition of this Field Type can be configured with several options:
| Name | Type | Default value | Description |
|---|
useSeconds | boolean | false | Used to control displaying of seconds in the output. |
defaultType | mixed | Type::DEFAULT_EMPTY | One of the DEFAULT_* constants, used by the administration interface for setting the default field value. See below for more details. |
dateInterval | null|\DateInterval | null | This setting complements defaultType setting and can be used only when latter is set to Type::DEFAULT_CURRENT_DATE_ADJUSTED. In that case the default input value when using administration interface will be adjusted by the given \DateInterval. |
Following defaultType default value options are available as constants in the eZ\Publish\Core\FieldType\DateAndTime\Type class:
| Constant | Description |
|---|
DEFAULT_EMPTY | Default value will be empty. |
DEFAULT_CURRENT_DATE | Default value will use current date. |
DEFAULT_CURRENT_DATE_ADJUSTED | Default value will use current date, adjusted by the interval defined in dateInterval setting. |
Template rendering
The template called by the ez_render_field() Twig function while rendering a Date field has access to the following parameters:
| Parameter | Type | Default | Description |
|---|
locale | string | | Internal parameter set by the system based on current request locale or if not set calculated based on the language of the field. |
Example:
