This Field Type represents a full date including time information.
| Name | Internal name | Expected input type |
|---|---|---|
DateAndTime | ezdatetime | mixed |
Table of contents:
Description
This Field Type makes possible to store and retrieve a full date including time information.
Input expectations
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 format
Hash value of this Field Type is an array with two keys:
| Key | Type | Description | Example |
|---|---|---|---|
| integer | Time information as a timestamp. |
|
| string | Time information as a string in RFC 850 date format. As input, this will have higher precedence over the | "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 See below for more details. |
dateInterval | null|\DateInterval | null | This setting complements In that case the default input value when using administration interface will be adjusted by the given |
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. |