Templater plugin (1.5 and newer): New Syntax and Examples

Hi @Moonbase59 thanks for all your info, this clarifies a lot. I hope you don’t mind if I have some follow-up questions. If this gets too much off topic I hope I can contact you via pm.

It’s a pity that the info cannot be updated after e.g. changes to a note. I thought that the Templater: Replace templates in the active file function would be able to do this. Do you know what this function does?

Do you know of a way how to have an updating ‘last modified’ header in the note?

It replaces templater code within the currently open file, so you don’t have to load an external template. Like, you type <% tp.file.last_modified_date() %>, then press Alt/Opt+R and you’ll get the file’s last modified date and time.

I never had much use for this (except for testing), since the templater code is replaced with its result and thus gone afterwards.

Nope. If you find one, let me know :wink: Then again, Obsidian’s File Explorer pane shows the last modified date if you hover the mouse over a file, and it could possibly be retrieved “live” using the Dataview plugin.

We must remember, after all, that Obsidian is a system to create/handle plain Markdown text notes and not a “live”, variable- or event-driven system like a website could be.

Thanks a lot! Crystal clear.

1 Like

FYI, here’s a link to the Templater Docs.

Since this thread is not only about durations anymore, I’ll change its title to “New Syntax and moment.js Examples” :slight_smile:

1 Like

Here’s another example that came up today: Make a H1 heading that has the first letter of the note’s title uppercased.

# <% tp.file.title.charAt(0).toUpperCase() + tp.file.title.slice(1) %>

Shows nicely how to unleash the powers of Javascript using the Templater plugin.


Another one: Cursor placement in Templates plugin (preferably also for Daily Notes template) - #7 by Moonbase59

1 Like

I asked the author of Dataview on GitHub and it is possible:
Put an inline codeblock like this in your file with this code.

`= this.file.mtime`

Now this is a great find—thank you!

Now we’ll only have to wait for …

  • date/time string formatting
  • date/time strings being localized into the currently set Obsidian language, not the system language

Templater 1.6+: Combining dynamic commands and Javascript commands (undocumented)

Say you have a front matter field deceased: but only want to calculate/show the date if it’s defined (or non-empty), and a simple - if not.

You can actually combine Templater’s <%+ (dynamic) and <%* (Javascript) “introducers” as follows:

Use <%+*—this should produce dynamic results (if I’m not being caught by caching again):

<%+* if (tp.frontmatter["deceased"]) {tR+=moment(tp.frontmatter.deceased).format("ddd, YYYY-MM-DD")} else {tR+="-"}; %>

Now isn’t Templater great?


Thanks for this discovery! This should be in the documentation already. I was looking for this since the day dynamic commands were released but in my attempts to try this, it never worked, I think I tried the asterisk before the plus and then tried the documentation and gave up. This could be so useful especially since we can call external APIs using fetch inside the template and process it as we like with JS.

Life is full of possibilities!


In case it’s helpful, here’s syntax for adding next/back date links to your daily note based on the note title – not today’s date:

<< [[<% tp.date.now("YYYY-MM-DD",-1,tp.date.now("YYYY-MM-DD", 0, tp.file.title, "YYYY-MM-DD"),"YYYY-MM-DD") %>]] | [[<% tp.date.now("YYYY-MM-DD",1,tp.date.now("YYYY-MM-DD", 0, tp.file.title, "YYYY-MM-DD"),"YYYY-MM-DD") %>]] >>

This assumes files are named in YYYY-MM-DD format; you’ll need to update all 8 date format declarations if you use a different format.


When I try to do the “Days until Christmas” example. I get “PT0.219S.” What am I doing wrong? It’s been years since I’ve done anything like this.

1 Like

Hm. Thanks for bringing this up!

Something must have changed, or I made a stupid mistake. I also get PT0.219S (ISO duration, meaning 0.219 seconds) where it should be 219 days.

At least

<% moment("12-24", "MM-DD").diff(moment(), "days") %>

shows 219 (the correct # days). Which should be enough for the intended “days til Xmas”.

If, for some reason, it needs to be more exact, one could probably use

<% moment.duration(moment("12-24", "MM-DD").diff(moment())).as('days') %>

to arrive at 219.278469375 (at this moment in time).

Sorry if I messed something up!


That totally worked.

…can I ask you an off-topic question because I can’t for the life of me figure out how to search for “u”…is {{date:u}} just impossible?

1 Like

Sounds like PHP, right? u is the timestamp in integer microseconds, right? I don’t think moment.js ever supported that.

In case of using (PHP) v (milliseconds), this is x with moment.js.

u is the number day of the week, with 1 being Monday.

it’s not vital, I’m just trying to get something to link to files in the format I had already used. I really appreciate you trying to help!

I just like interesting problems :wink:

Day-of-the-week could be either d, e or E, according to the docs. For today, they all show 2 here:

<% moment().format('d - e - E') %>

You probably want E which returns 1–7 for Mon–Sun.


E worked! you are fantastic. :heart_eyes:

1 Like

Happy to help :slight_smile:

1 Like

While we’re at it …

Days until …, done right

This is a little longer, but it will check if it’s already past the date for this year, and show the difference in days until the same date next year!

This is ideal for recurring events like Christmas, Birthdays, Anniversaries, etc.

To make things simple, I use JS to set a variable at the beginning. This allows editing just one place instead of many.

<!-- Days until any "MM-DD" date this year/next year -->
<%+* let edate = moment("12-24", "MM-DD"); let from = moment().startOf('day'); edate.diff(from, "days") >= 0 ? tR += edate.diff(from, "days") : tR += edate.add(1, "year").diff(from, "days") %>

Days until …, plus “It’s Today!”

Same as above, but will display “It’s today!” instead of a plain old zero if we happen to be on the date.

<!-- Days until any "MM-DD" date this year/next year with "TODAY" -->
<%+* let edate = moment("12-24", "MM-DD"); let from = moment().startOf('day'); edate.diff(from, "days") >= 0 ? edate.diff(from, "days") == 0 ? tR += "It’s today!" : tR += edate.diff(from, "days") : tR += edate.add(1, "year").diff(from, "days") %>

Enjoy! (And never again worry about “days to Christmas” being -2!)