This Field Type represents time information.
| Name | Internal name | Expected input type |
|---|
Time | eztime | mixed |
Description
This Field Type makes possible to store and retrieve 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 |
|---|
$time | integer|null | Holds the time information as a number of seconds since the beginning of the day. |
Constructor
The constructor for this value object will initialize a new Value object with the value provided. It accepts an integer representing the number of seconds since the beginning of the day.
String representation
String representation of the date value will generate the date string in the format "H:i:s" as accepted by PHP's built-in date() function.
Example:
"12:14:56"
Value in hash format is an integer representing a number of seconds since the beginning of the day.
Example:
36000
Validation
This Field Type does not perform 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 | Type::DEFAULT_EMPTY
Type::DEFAULT_CURRENT_TIME | Type::DEFAULT_EMPTY | The constant used here defines default input value when using administration interface. |
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:
