Jump to content

Template:Vgrtbl/doc

From Wikipedia, the free encyclopedia

For dates from January 1, 1970 onward only!

This template takes one or more region code/release date pairs and formats them in a way that makes them sort properly in sortable tables.

Usage

[edit]

Parameters are inputted as region code/date pairs, and are displayed in the order they are given. WP:VG/DATE asserts several guidelines/rules concerning where and when (and which) abbreviations may be used in video game infoboxes, specifically:

Release dates should be provided from primarily English-speaking regions, including North America, Europe, and Australia/New Zealand. If the video game is first released in a non-English country, commonly in Japan, then that should also be stated ... Releases in non-English countries should not be included in the infobox (unless it is first released in a non-English country), but if determined to be necessary to include, can be discussed further in the article's body.

By default, or when the optional v parameter is set to equal 1, the template outputs dates in "verbose" mode with the exact display appearance depending on the user's date and time preferences. If a user has no preferences set (such as is the case with an unregistered user), then the "MONTHNAME D, YYYY" format is used by default. By setting the optional v parameter to equal zero, the template will output dates in "YYYY-MM-DD" format instead. Setting v to equal 2 forces the "D MONTHNAME YYYY" format. However, note that the v parameter has no effect if the date given consists only of a year.

Dates may be entered either in the form of a year by itself, a month and a year or any full date supported by the #time: parser function. When inputting a month and year instead of only a year or full date, the template will result in an error if the input isn't in the "MONTHNAME YYYY" format (e.g., July 2001). If you need to enter something other than a date (such as "TBA" or "TBD"), you may do so; any text inputted will be returned as entered and without changes.

By default this template collapses dates to a single entry when they are identical; however, this feature can be disabled by setting the optional c parameter to equal zero.

This template works only with dates from January 1, 1970 onward.

Examples

[edit]
Code (v=1, default) Output
{{Vgrtbl|NA|1989-03-12|EU|August 16, 2008}} 19890319890312March 12, 1989 (NA)
August 16, 2008 (EU)
{{Vgrtbl|NA|1989-03-12|EU|12 March 1989}} 19890319890312March 12, 1989 (NA/EU)
{{Vgrtbl|c=0|NA|1989-03-12|EU|12 March 1989}} 19890319890312March 12, 1989 (NA)
March 12, 1989 (EU)
{{Vgrtbl|NA|1989|EU|March 1989}} 1989 (NA)
March 1989 (EU)
{{Vgrtbl|NA|Cancelled|JP|TBD|EU|TBA|AUS|TBA}} Cancelled (NA)
TBD (JP)
TBA (EU/AUS)
Code (v=0) Output
{{Vgrtbl|v=0|NA|1989-03-12|EU|August 16, 2008}} 198903198903121989-03-12 (NA)
2008-08-16 (EU)
{{Vgrtbl|v=0|NA|1989-03-12|EU|12 March 1989}} 198903198903121989-03-12 (NA/EU)
{{Vgrtbl|c=0|v=0|NA|1989-03-12|EU|12 March 1989}} 198903198903121989-03-12 (NA)
1989-03-12 (EU)
{{Vgrtbl|v=0|NA|1989|EU|March 1989} 1989 (NA)
1989-03 (EU)
Code (v=2) Output
{{Vgrtbl|v=2|NA|1989-03-12|EU|August 16, 2008}} 1989031989031212 March 1989 (NA)
16 August 2008 (EU)
{{Vgrtbl|v=2|NA|1989-03-12|EU|12 March 1989}} 1989031989031212 March 1989 (NA/EU)
{{Vgrtbl|c=0|v=2|NA|1989-03-12|EU|12 March 1989}} 1989031989031212 March 1989 (NA)
12 March 1989 (EU)
{{Vgrtbl|v=2|NA|1989|EU|March 1989} 1989 (NA)
March 1989 (EU)

See also

[edit]