ReNamer:Date and Time format

From den4b Wiki
Revision as of 02:25, 11 November 2018 by Den4b (talk | contribs) (Moved the dagger footnote to a more appropriate sentence.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Arrow Return.png ReNamer  

Date and time format is mostly used by the Meta Tags and PascalScript rule to format date and time values. The format consists of a series of placeholder characters (or variables) corresponding to year, month, day, hour and so on.

You can change the format used for the Meta Tags in the Settings dialog.

Below is a list of variables which you can use.

Variable Description
d
Displays the day as a number without a leading zero (1-31).
dd
Displays the day as a number with a leading zero (01-31).
ddd
Displays the day as an abbreviation (Sun-Sat).
dddd
Displays the day as a full name (Sunday-Saturday).
e
Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only).
ee
Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only).
g
Displays the period/era as an abbreviation (Japanese and Taiwanese locales only).
gg
Displays the period/era as a full name. (Japanese and Taiwanese locales only).
m
Displays the month as a number without a leading zero (1-12).
If the "m" specifier immediately follows an "h" or "hh" specifier then minute is displayed.
mm
Displays the month as a number with a leading zero (01-12).
If the "mm" specifier immediately follows an "h" or "hh" specifier then minute is displayed.
mmm
Displays the month as an abbreviation (Jan-Dec).
mmmm
Displays the month as a full name (January-December).
yy
Displays the year as a two-digit number (00-99).
yyyy
Displays the year as a four-digit number (0000-9999).
h
Displays the hour without a leading zero (0-23).
hh
Displays the hour with a leading zero (00-23).
n
Displays the minute without a leading zero (0-59).
nn
Displays the minute with a leading zero (00-59).
s
Displays the second without a leading zero (0-59).
ss
Displays the second with a leading zero (00-59).
z
Displays the millisecond without a leading zero (0-999).
zzz
Displays the millisecond with a leading zero (000-999).
am/pm
Use the 12-hour clock notation for "h" and "hh" specifiers, and display "am" or "pm" accordingly.
The "am/pm" specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
a/p
Use the 12-hour clock notation for "h" and "hh" specifiers, and display "a" or "p" accordingly.
The "a/p" specifier can use lower, upper, or mixed case, and the result is displayed accordingly.
"xx"
Characters enclosed in single or double quotes are displayed as-is, and the formatting is not applied to them.

For example, if we assume that the date is 25-th of October 2007 and the time is 16:59:00, then sample formats and their outputs would be:

  • dd-mm-yyyy hh.nn.ss format will produce 25-10-2007 16.59.00, which is an easily readable format for the date and time.
  • "It's" dddd, hh:nn:ss AM/PM format will produce It's Thursday, 4:59:00 PM, which is unsuitable for filenames because of : forbidden character.
  • yyyymmddhhnnss format will produce 20071025165900, which is ideal for serializing files because the filename is relatively short, most probably unique, contains only digits, and also makes files automatically sorted in chronological order.

Prior to ReNamer v6.0, am/pm and a/p specifiers affected only the immediately preceding h and hh specifiers.