Skip to content Skip to footer navigation
Light theme Dark theme
You are reading the docs for an old version of Statamic. Consider upgrading to Statamic 6.

Relative Modifier

Returns a date difference in a nice, human readable, string format. This modifier will add a phrase after the difference value relative to the current date and the passed in date.

You can turn off the extra words "ago", "until", and so on by passing true as a parameter

The string will be localized into your current site locale.

past_date: October 1 2020

future_date: October 1 2024

{{ past_date | relative }}

{{ past_date | relative(true) }}

{{ future_date | relative }}

{{ future_date | relative(true) }}

{{ Statamic::modify($past_date)->relative() }}

{{ Statamic::modify($past_date)->relative(true) }}

{{ Statamic::modify($future_date)->relative() }}

{{ Statamic::modify($future_date)->relative(true) }}

2 years ago

2 years

1 year from now

1 year