Timber\DateTimeHelper

Helper class to work with dates and times.

Overview #

Name	Return Type	Summary/Returns
time_ago()	`string`	Returns the difference between two times in a human readable format.
wp_date()	`false` or `string`	Wrapper for wp_date().

Returns the difference between two times in a human readable format.

Differentiates between past and future dates.

see human_time_diff()

time_ago( int|string $from, int|string $to = null, string $format_past = null, string $format_future = null )

Returns: string

Name	Type	Description
$from	`int` or `string`	Base date as a timestamp or a date string.
$to	`int` or `string`	Optional. Date to calculate difference to as a timestamp or a date string. Default current time.
$format_past	`string`	Optional. String to use for past dates. To be used with `sprintf()`. Default `%s ago`.
$format_future	`string`	Optional. String to use for future dates. To be used with `sprintf()`. Default `%s from now`.

Twig

{{ post.date('U')|time_ago }}
{{ post.date('Y-m-d H:i:s')|time_ago }}
{{ post.date(constant('DATE_ATOM'))|time_ago }}

Wrapper for wp_date().

since 2.0.0

Returns: false|string

Name	Type	Description
$format	`null` or `string` or `false`	Optional. PHP date format. Will use the `date_format` option as a default.
$date	`string` or `int` or `\DateTimeInterface`	A date.
$timezone	`null` or `\DateTimeZone`	Optional. Timezone to output result in. Defaults to timezone from site settings.