Difference between revisions of "ReNamer:Date and Time format"
Jump to navigation
Jump to search
m (table header adjusted) |
|||
| Line 1: | Line 1: | ||
| − | Date-Time format is mostly used by the meta tags. You can define almost any thinkable format for all tags which extract a date-time field from the file. You can change it from within the Settings. Below is a list of variables which you can use. | + | Date-Time format is mostly used by the [[ReNamer:Meta_Tags|meta tags]]. You can define almost any thinkable format for all tags which extract a date-time field from the file. You can change it from within the Settings. Below is a list of variables which you can use. |
{| class="prettytable" | {| class="prettytable" | ||
| − | ! Variable | + | |- |
| + | ! Variable | ||
! Description | ! Description | ||
| − | |||
|- | |- | ||
| − | | <center>'''d'''</center> | + | | <center>'''d'''</center> |
| Displays the day as a number without a leading zero (1-31). | | Displays the day as a number without a leading zero (1-31). | ||
| − | |||
|- | |- | ||
| − | | <center>'''dd'''</center> | + | | <center>'''dd'''</center> |
| Displays the day as a number with a leading zero (01-31). | | Displays the day as a number with a leading zero (01-31). | ||
| − | |||
|- | |- | ||
| − | | <center>'''ddd'''</center> | + | | <center>'''ddd'''</center> |
| Displays the day as an abbreviation (Sun-Sat). | | Displays the day as an abbreviation (Sun-Sat). | ||
| − | |||
|- | |- | ||
| − | | <center>'''dddd'''</center> | + | | <center>'''dddd'''</center> |
| Displays the day as a full name (Sunday-Saturday). | | Displays the day as a full name (Sunday-Saturday). | ||
| − | |||
|- | |- | ||
| − | | <center>'''e'''</center> | + | | <center>'''e'''</center> |
| Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only). | | Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only). | ||
| − | |||
|- | |- | ||
| − | | <center>'''ee'''</center> | + | | <center>'''ee'''</center> |
| Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only). | | Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only). | ||
| − | |||
|- | |- | ||
| − | | <center>'''g'''</center> | + | | <center>'''g'''</center> |
| Displays the period/era as an abbreviation (Japanese and Taiwanese locales only). | | Displays the period/era as an abbreviation (Japanese and Taiwanese locales only). | ||
| − | |||
|- | |- | ||
| − | | <center>'''gg'''</center> | + | | <center>'''gg'''</center> |
| Displays the period/era as a full name. (Japanese and Taiwanese locales only). | | Displays the period/era as a full name. (Japanese and Taiwanese locales only). | ||
| − | |||
|- | |- | ||
| − | | <center>'''m'''</center> | + | | <center>'''m'''</center> |
| 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. | | 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. | ||
| − | |||
|- | |- | ||
| − | | <center>'''mm'''</center> | + | | <center>'''mm'''</center> |
| 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. | | 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. | ||
| − | |||
|- | |- | ||
| − | | <center>'''mmm'''</center> | + | | <center>'''mmm'''</center> |
| Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable. | | Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable. | ||
| − | |||
|- | |- | ||
| − | | <center>'''mmmm'''</center> | + | | <center>'''mmmm'''</center> |
| Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable. | | Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable. | ||
| − | |||
|- | |- | ||
| − | | <center>'''yy'''</center> | + | | <center>'''yy'''</center> |
| Displays the year as a two-digit number (00-99). | | Displays the year as a two-digit number (00-99). | ||
| − | |||
|- | |- | ||
| − | | <center>'''yyyy'''</center> | + | | <center>'''yyyy'''</center> |
| Displays the year as a four-digit number (0000-9999). | | Displays the year as a four-digit number (0000-9999). | ||
| − | |||
|- | |- | ||
| − | | <center>'''h'''</center> | + | | <center>'''h'''</center> |
| Displays the hour without a leading zero (0-23). | | Displays the hour without a leading zero (0-23). | ||
| − | |||
|- | |- | ||
| − | | <center>'''hh'''</center> | + | | <center>'''hh'''</center> |
| Displays the hour with a leading zero (00-23). | | Displays the hour with a leading zero (00-23). | ||
| − | |||
|- | |- | ||
| − | | <center>'''n'''</center> | + | | <center>'''n'''</center> |
| Displays the minute without a leading zero (0-59). | | Displays the minute without a leading zero (0-59). | ||
| − | |||
|- | |- | ||
| − | | <center>'''nn'''</center> | + | | <center>'''nn'''</center> |
| Displays the minute with a leading zero (00-59). | | Displays the minute with a leading zero (00-59). | ||
| − | |||
|- | |- | ||
| − | | <center>'''s'''</center> | + | | <center>'''s'''</center> |
| Displays the second without a leading zero (0-59). | | Displays the second without a leading zero (0-59). | ||
| − | |||
|- | |- | ||
| − | | <center>'''ss'''</center> | + | | <center>'''ss'''</center> |
| Displays the second with a leading zero (00-59). | | Displays the second with a leading zero (00-59). | ||
| − | |||
|- | |- | ||
| − | | <center>'''z'''</center> | + | | <center>'''z'''</center> |
| Displays the millisecond without a leading zero (0-999). | | Displays the millisecond without a leading zero (0-999). | ||
| − | |||
|- | |- | ||
| − | | <center>'''zzz'''</center> | + | | <center>'''zzz'''</center> |
| Displays the millisecond with a leading zero (000-999). | | Displays the millisecond with a leading zero (000-999). | ||
| − | |||
|- | |- | ||
| − | | <center>'''am/pm'''</center> | + | | <center>'''am/pm'''</center> |
| Uses the 12-hour clock for the preceding h or hh specifier, and displays "am" for any hour before noon, and "pm" for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly. | | Uses the 12-hour clock for the preceding h or hh specifier, and displays "am" for any hour before noon, and "pm" for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly. | ||
| − | |||
|- | |- | ||
| − | | <center>'''a/p'''</center> | + | | <center>'''a/p'''</center> |
| Uses the 12-hour clock for the preceding h or hh specifier, and displays "a" for any hour before noon, and "p" for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly. | | Uses the 12-hour clock for the preceding h or hh specifier, and displays "a" for any hour before noon, and "p" for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly. | ||
| − | |||
|- | |- | ||
| − | | <center>'''"xx"'''</center> | + | | <center>'''"xx"'''</center> |
| Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting. | | Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting. | ||
| + | |} | ||
| − | + | For example, if 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: | |
| − | For example, if 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. | + | *"'''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. |
| − | * "'''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. | + | *"'''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. |
Revision as of 13:27, 1 August 2009
Date-Time format is mostly used by the meta tags. You can define almost any thinkable format for all tags which extract a date-time field from the file. You can change it from within the Settings. Below is a list of variables which you can use.
| Variable | Description |
|---|---|
| Displays the day as a number without a leading zero (1-31). | |
| Displays the day as a number with a leading zero (01-31). | |
| Displays the day as an abbreviation (Sun-Sat). | |
| Displays the day as a full name (Sunday-Saturday). | |
| Displays the year in the current period/era as a number without a leading zero (Japanese, Korean and Taiwanese locales only). | |
| Displays the year in the current period/era as a number with a leading zero (Japanese, Korean and Taiwanese locales only). | |
| Displays the period/era as an abbreviation (Japanese and Taiwanese locales only). | |
| Displays the period/era as a full name. (Japanese and Taiwanese locales only). | |
| 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. | |
| 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. | |
| Displays the month as an abbreviation (Jan-Dec) using the strings given by the ShortMonthNames global variable. | |
| Displays the month as a full name (January-December) using the strings given by the LongMonthNames global variable. | |
| Displays the year as a two-digit number (00-99). | |
| Displays the year as a four-digit number (0000-9999). | |
| Displays the hour without a leading zero (0-23). | |
| Displays the hour with a leading zero (00-23). | |
| Displays the minute without a leading zero (0-59). | |
| Displays the minute with a leading zero (00-59). | |
| Displays the second without a leading zero (0-59). | |
| Displays the second with a leading zero (00-59). | |
| Displays the millisecond without a leading zero (0-999). | |
| Displays the millisecond with a leading zero (000-999). | |
| Uses the 12-hour clock for the preceding h or hh specifier, and displays "am" for any hour before noon, and "pm" for any hour after noon. The am/pm specifier can use lower, upper, or mixed case, and the result is displayed accordingly. | |
| Uses the 12-hour clock for the preceding h or hh specifier, and displays "a" for any hour before noon, and "p" for any hour after noon. The a/p specifier can use lower, upper, or mixed case, and the result is displayed accordingly. | |
| Characters enclosed in single or double quotes are displayed as-is, and do not affect formatting. |
For example, if 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.
- "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.