Years Since – Timeless Texts


Keep date time related texts relevant. β€œI have worked for x years.” becomes outdated within a year. Years since keeps β€œx” current in your posts and allow your content to age well.


A year must be provided in your text by the attribute β€œy” such as [years-since y=2012].
As an option, Months by referencing β€œm” and day by using β€œd”. Months and day default to β€œ1” if not added in the shortcode.

For example, on an β€œAbout” page text, you might have something like:

We’ve worked remotely for [years-since y=2012], which has allowed the team to spend more time traveling and spending time with family.
Or, if you wanted to update a time span on a particular anniversary, you could do something like:
I’m [years-since y=1990 m=5 d=16] old.

More attributes

Add specific HTML tag to the calculation with the html attrribute e.g.

[years-since y=1990 html=span] will wrap the output in a span tag.

Add a text attribute with value false i.e.
[years-since y=1990 text=false] will remove the text years from the calculation.

It will output 23 instead of 23 years.


  • Fix: Breaking month and day output.
  • Add: Testing for WP 6.5.2
  • Add: Require PHP 8.2.0
  • Add: Require PHP 7.4
  • Add: Function arguments and Return Type hinting.
  • Add: A testing framework with pest with CI.
  • Fix: Deprecate Editor poylfill function for the block editor.


  • Fix: Breaking change HTML Default argument paragraph html attribute as β€œp” for the shortcode output.


  • Fix: Restore minus text format for the calculations.
  • Add: Translations file build + .pot.
  • Add: Default attributes for the shortcode.
  • New: HTML Default argument paragraph html attribute as β€œp” for the shortcode output.


  • Fix: Time calculations and messaging.
  • Test: WP 6.3.1.
  • Test: PHP 8.2.10.


  • Fix or to ||


  • Namespace the plugin to avoid PHP conflicts.
  • Fix the breaking html when [years-since-gb] is used.
  • Test WP version compatibility for 5.6.


  • Add functionality to allow for days, months, weeks instead of 0 years when time is less than a year.


  • Add Gutenberg support


  • Add Gutenberg note to readme.


  • Translate returned errors.
  • Shortcode parameter to suppress β€œyear” and β€œyears” text.


  • Initial creation.


  • Sample shortcodes added in the editor.
  • Preview of the shortcodes on the front end.


  • Navigate to your plugins admin page.
  • Search for β€œyears since” and download the plugin.
  • Install using the plugin admin interface.


Does it work with the Block Editor/Gutenberg?


Does it work with ClassicPress?

Yes. This will still work even if you revert to the Classic Editor seamlessly.

How can I contribute?

You can raise lots of issues here and also make some Pull Requests through github


πŸ‚ πŸ”Ÿ 6, 2023
this is a unique plugin with only one job that maybe you would not need in every website, but it is very useful, and it does its job wellThanks for updating it!
πŸ‚ 9️⃣ 24, 2020
A well-thought-out solution, sleek and elegantly coded. I love the functionality that allows for days, months and weeks instead of 0 years when time passed is less than a year. Congratulations @laurencebahiirwa and a big thank you!
Read all 5 reviews

Contributors & Developers

“Years Since – Timeless Texts” is open source software. The following people have contributed to this plugin.


“Years Since – Timeless Texts” has been translated into 5 locales. Thank you to the translators for their contributions.

Translate “Years Since – Timeless Texts” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.