Time Field Type

=20

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.

Date information is not stored.

What is stored is the number of seconds, calculated from the beginning o= f the day in the given or the environment timezone.

PHP API Field Type

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 appl= y.

It is also possible to directly pass an instance of \DateT= ime.

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 nu= mber of seconds since the beginning of the day.

Constructor

The constructor for this value object will initialize a new Value o= bject with the value provided. It accepts an integer representing the numbe= r 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 buil= t-in date() function.

Example:

"12:14:56"

Hash format

Value in hash format is an integer representing a number of second= s 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 o= ptions:

Name Type Default value Description

useSeconds
boolean false Used to control displaying of seco= nds in the output.

defaultType

Type::DEFAULT_EMPTY
Type::= DEFAULT_CURRENT_TIME

Type::DEFAULT_EMPTY
The constant used here defines def= ault input value when using administration interface.

Time Field Type example settings

=20
use eZ\Publish\Core\FieldType\Time\Type; $settings =3D array( =09"defaultType" =3D> DateAndTime::DEFAULT_EMPTY );
=20

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 cu= rrent request locale or if not set calculated based on the language of the = field.

Example:

=20
{{ ez_render_field(content, 'time') }}
=20

Type	Example
`string`	`"2012-08-28 12:20 Europe/Berlin"`
integer	1346149200
\DateTime	new \DateTime()

Property	Type	Description
`$time`	`integer\|null`	Holds the time information as a nu= mber of seconds since the beginning of the day.

Name	Type	Default value	Description
useSeconds	`boolean`	`false`	Used to control displaying of seco= nds in the output.
defaultType	Type::DEFAULT_EMPTY Type::= DEFAULT_CURRENT_TIME	Type::DEFAULT_EMPTY	The constant used here defines def= ault input value when using administration interface.

Parameter	Type	Default	Description
`locale`	`string`		Internal parameter set by the system based on cu= rrent request locale or if not set calculated based on the language of the = field.

=20

=20
=20
=20

=20
=20

=20