Date and Time format
Date and time format is used primarily in Meta Tags and the Pascal Script 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 in the Settings.
Format variables
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. |
Examples
For example, if we assume that the date is 25 October 2007 and the time is 16:59:00, then sample formats and their outputs would be:
| Format | Output |
|---|---|
dd-mm-yyyy hh.nn.ss |
Produces 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 |
Produces It's Thursday, 4:59:00 PM, which is unsuitable for filenames because of : forbidden character. |
yyyymmddhhnnss |
Produces 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.