datetime — a date
A game's release date, or that of the last play.
A datetime displays a date Recalbox knows, never free text. Its name says which date — md_releasedate the game's release, md_lastplayed the last play — and its display property says in which form to write it.
<datetime name="md_releasedate">
<pos>0.06 0.66</pos>
<fontSize>0.028</fontSize>
<color>C6CBD8</color>
<display>date</display>
</datetime>display — the date's form
| To write | What shows |
|---|---|
date | 1991/06/23 |
dateTime | 1991/06/23 14:05:30 |
year | 1991 |
time | 14:05:30 |
realTime | the current time — not a game date |
RelativeToNow | “3 days ago” |
⚠️ Case matters. datetime does not work, it must be dateTime; neither does relativeToNow, it must be RelativeToNow. An unknown value keeps the previous form and lands in themes.log.
The properties (12)
| Property | Role |
|---|---|
pos size origin | placement |
display | the date's form |
color backgroundColor | colors |
fontPath fontSize | font |
alignment forceUppercase | formatting |
zIndex disabled | depth, switching off |
⚠️ A datetime without color is invisible: it is the only component that resets the color to zero instead of keeping the previous one. And of alignment, only the horizontal part is kept — the vertical is always centered.
A game without a date shows an empty line: it is the data that is missing, not the theme.