Skip to content

Date & time

Date position

Where a card's date is shown:

  • In the card footer (default) — at the bottom of the card, with a calendar icon, the time and, with Show relative date, the relative date ("in 3 days"). Click the date or the time to change it. Cards without a date have no footer.
  • In the card text — inside the card text, where it is written.
  • In the card text and footer — in both places.

This replaces the earlier Move dates to card footer switch: a board where it was on shows dates in the footer, a board where it was off keeps them in the text.

Date syntax

How card dates are written into markdown:

  • @{date} @@{time} (default) — @{2026-10-14} and @@{13:25}, using the triggers and formats below.
  • Tag — an Obsidian tag: #26-10-14, or #26-10-14-13-25-20 with a time. The triggers still open the pickers. Date format and Time format no longer control what is written, but still control how dates and times are shown (unless Date display format is set). Link dates to daily notes does not apply. See Dates as tags.

Dates written the other way are no longer recognised, but your files are not changed: switching back brings them back.

Show date tags as written

Only with the Tag date syntax. When on, the card shows its date tag as it is written (#26-10-14-13-25-20) instead of the date and time in the display formats. It stays a real tag, so CSS for tags applies to it, and keeps the date colours. Clicking it opens the calendar, not the tag search. Off by default.

Date trigger

The character (or sequence of characters) that opens the date picker while editing a card. Default: @.

Date trigger setting

Time trigger

The character (or sequence) that opens the time picker. Default: @@.

Time trigger setting

Date format

The format a date is saved as in markdown. Uses moment.js tokens.

YYYY-MM-DD:

Date format YYYY-MM-DD

ddd, MMM Do, YYYY:

Date format ddd, MMM Do, YYYY

Time format

The format a time is saved as. Uses moment.js tokens.

HH:mm:

Time format HH:mm

h:mm a:

Time format h:mm a

Date display format

How a card's date is shown, independent of Date format used to save it.

Setting the date display format

A card with a date in the current Date format:

A card with a saved date

...shown using the display format:

The date shown using the display format

Show relative date

Shows the distance between today and a card's date (e.g. "In 3 days", "A month ago") instead of a fixed date. Not applied to dates from the Tasks and Dataview plugins.

A relative date on a card

Makes a card's date link to the matching daily note, e.g. [[2021-04-26]].

A date linking to a daily note The linked daily note

Calendar: first day of week

Overrides which day the date picker's calendar starts each week on. Default: follows Obsidian's own setting.