Published 2020-10-03.
Last modified 2023-05-18.
Time to read: 1 minutes.
jekyll_plugins
collection, categorized under Jekyll.
time_since
is a collection of Liquid filters that return the elapsed time since a date or date and time.
The filters are years_since
, months_since
, days_since
, hours_since
, minutes_since
and seconds_since
.
Installation
Add the following highlighted line to your Jekyll project's Gemfile
,
within the jekyll_plugins
group:
group :jekyll_plugins do gem 'jekyll_time_since' end
And then execute:
$ bundle
Usage Examples
These tags all work in a similar manner;
they accept one parameter, which is either a date string (YYYY-MM-dd
) or
an ISO 8601-1:2019 datetime string (YYYY-MM-ddThh:mm
).
Just a year can be specified, which implies Jan 1 at midnight.
The date and time strings can be surrounded with quotes or double quotes.
Time zone can be omitted, or specified as GMT
, Z
, or +/- HHMM/code>.
{{ "1959" | years_since }}: 64 {{ "1959-02-03" | years_since }}: 64 {{ "1959-02-03T01:02" | years_since }}: 64 {{ "1959-02-03T01:02:00Z" | years_since }}: 64 {{ "1959" | months_since }}: 773 {{ "1959-02-03" | months_since }}: 772 {{ "1959-02-03T01:02" | months_since }}: 772 {{ "1959-02-03T01:02:00Z" | months_since }}: 772 {{ "1959" | weeks_since }}: 3361 {{ "1959-02-03" | weeks_since }}: 3356 {{ "1959-02-03T01:02" | weeks_since }}: 3356 {{ "1959-02-03T01:02:00Z" | weeks_since }}: 3356 {{ "1959" | days_since }}: 23530 {{ "1959-02-03" | days_since }}: 23497 {{ "1959-02-03T01:02" | days_since }}: 23497 {{ "1959-02-03T01:02:00Z" | days_since }}: 23497 {{ "1959" | hours_since}}: 564726 {{ "1959-02-03" | hours_since }}: 563934 {{ "1959-02-03T01:02" | hours_since }}: 563933 {{ "1959-02-03T01:02:00Z" | hours_since }}: 563938 {{ "1959" | minutes_since }}: 33883597 {{ "1959-02-03" | minutes_since }}: 33836077 {{ "1959-02-03T01:02" | minutes_since }}: 33836015 {{ "1959-02-03T01:02:00Z" | minutes_since }}: 33836315 {{ "1959" | seconds_since }}: 2033015858 {{ "1959-02-03" | seconds_since }}: 2030164658 {{ "1959-02-03T01:02" | seconds_since }}: 2030160938 {{ "1959-02-03T01:02:00" | seconds_since }}: 2030160938