class DateTime (View source)

Methods

DateTime|string|null
translate(string $field, array $arr = null, bool $asDateTime = false)

Takes a "field" and grabs all the corresponding disparate fields from $_POST and translates into a timestamp.

string
datetime(string $field, DateTime|string $value = null, bool $includeActivation = false, bool $calendarAutoStart = true, string $classes = null, int $timeResolution = 60, array $datePickerOptions = array())

Creates form fields and JavaScript calendar includes for a particular item (date/time string representations will be converted from the user system-zone to the time-zone).

string
date(string $field, DateTime|string $value = null, bool $calendarAutoStart = true, array $datePickerOptions = array())

Creates form fields and JavaScript calendar includes for a particular item but includes only calendar controls (no time, so no time-zone conversions will be applied).

int
selectNearestValue(array $values, int $wantedValue)

Choose an array value nearest to a specified value.

Details

DateTime|string|null translate(string $field, array $arr = null, bool $asDateTime = false)

Takes a "field" and grabs all the corresponding disparate fields from $_POST and translates into a timestamp.

If $field has both date and time, the resulting value will be converted from the user timezone to the system timezone. If $field has only date and not time, no timezone conversion will occur.

Parameters

string $field The name of the field to translate
array $arr The array containing the value. If null (default) we'll use $_POST
bool $asDateTime Set to true to get a DateTime object, false (default) for a string representation

Return Value

DateTime|string|null In case of success returns the timestamp (in the format 'Y-m-d H:i:s' or 'Y-m-d' if $asDateTime is false) or the DateTime instance (if $asDateTime is true); if the date/time was not received we'll return null (if $field value is empty)

string datetime(string $field, DateTime|string $value = null, bool $includeActivation = false, bool $calendarAutoStart = true, string $classes = null, int $timeResolution = 60, array $datePickerOptions = array())

Creates form fields and JavaScript calendar includes for a particular item (date/time string representations will be converted from the user system-zone to the time-zone).

Parameters

string $field The field prefix (will be used as $field parameter in the translate method)
DateTime|string $value The initial value
bool $includeActivation Set to true to include a checkbox to enable/disable the date/time fields
bool $calendarAutoStart Set to false to avoid initializing the Javascript calendar
string $classes A list of space-separated classes to add to the ui-datepicker-div container
int $timeResolution The time resolution in seconds (60 means we won't ask seconds)
array $datePickerOptions datepicker properties, see jquery-ui datepicker docs

Return Value

string

string date(string $field, DateTime|string $value = null, bool $calendarAutoStart = true, array $datePickerOptions = array())

Creates form fields and JavaScript calendar includes for a particular item but includes only calendar controls (no time, so no time-zone conversions will be applied).

Parameters

string $field The field name (will be used as $field parameter in the translate method)
DateTime|string $value The initial value
bool $calendarAutoStart Set to false to avoid initializing the Javascript calendar
array $datePickerOptions datepicker properties, see jquery-ui datepicker docs

Return Value

string

protected int selectNearestValue(array $values, int $wantedValue)

Choose an array value nearest to a specified value.

Useful when we work with time resolutions.

Parameters

array $values
int $wantedValue

Return Value

int