The Time Field Type

This Field Type represents time information.

Name	Internal name	Expected input type
`Time`	`eztime`	`mixed`

Table of contents:

=20

Description
Input expectations<= /li>=20
Value object=20
- Properties
- Constructor
- String representatio= n
Hash format
Validation
Settings

=20

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.

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

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

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.