General

  eZ Systems Website
  Editor documentation


  Developer documentation

  Back to the top

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: layout change

This Field Type represents time information.

NameInternal nameExpected input type
Timeeztimemixed

Table of contents:

Table of Contents
minLevel2

Description

This Field Type makes possible to store and retrieve time information.

Note

Date information is not stored.

What is stored is the number of seconds, calculated from the beginning of 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 apply.

It is also possible to directly pass an instance of \DateTime.

TypeExample
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:

PropertyTypeDescription
$timeinteger|nullHolds 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"

Hash format

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:

NameTypeDefault valueDescription
useSeconds
booleanfalseUsed 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.
Code Block
languagephp
titleTime Field Type example settings
linenumberstrue
use eZ\Publish\Core\FieldType\Time\Type;

$settings = array(
	"defaultType" => DateAndTime::DEFAULT_EMPTY
);