Template:Film date

()

Template documentation[view] [edit] [history] [purge]

This template is used on approximately 119,000 pages.
To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

Purpose

This template has two functions:

To provide correct formatting of film release dates and their locations within {{Infobox film}}. A citation for each date/location may also be supplied.
To automatically categorize films according to their first release date.

Usage

This template is intended to supply a result to the |released= parameter of {{Infobox film}}.

The template adds Category:YYYY films where YYYY is the year of first release, as well as Category:Upcoming films for films that have not reached their first release yet. Please note that Category:YYYY films will only be added if the category exists, and that if only the year is included as the release date, the film is considered to be "upcoming" during that entire year.

The television equivalents of these categories (Category:YYYY television films and Category:Upcoming television films) are used when the |TV= parameter is set for use on television film articles.

Syntax

This template allows up to five release dates/locations, but normally no more than two are needed. Please see WP:FILMRELEASE for a full explanation.

One release date only

{{Film date|year|month|day|location|ref1=<ref name="xxxxx" />}}

If no location is specified, month and day may be omitted. If location is specified, then month and day must be supplied, though they may be left blank or empty if not known; ref1= is an optional parameter allowing a named reference ("xxxxx") to be used to verify the date/location of the release.

More than one release date

{{Film date|year1|month1|day1|location1|ref1=<ref name="xxxxx" />|year2|month2|day2|location2|ref2=<ref name="yyyy" />}} and similarly for up to five dates/locations.

In this case, all the year, month, day and location parameters, except the last, must be supplied, but as before, month and day may be left empty or blank if not known. Note that ref1=, ref2=, etc. are optional named parameters, and either may be omitted without affecting the other parameters.

Examples

{{Film date|1993}} returns:

1993 (1993)

{{Film date|1993|02}} returns:

February 1993 (1993-02)

{{Film date|1993|02|24}} returns:

February 24, 1993 (1993-02-24)

{{Film date|1993|February|24}} returns:

February 24, 1993 (1993-February-24)

{{Film date|1993|02|24||2008|03}} returns:

February 24, 1993 (1993-02-24)
March 2008 (2008-03)

{{Film date|1993|02|24|Latvia}} returns:

February 24, 1993 (1993-02-24) (Latvia)

{{Film date|1993|02|24||2008|03|23}} returns:

February 24, 1993 (1993-02-24)
March 23, 2008 (2008-03-23)

Optional parameters

df can be set to "y" or "yes" to display the day before the month. Default is month before day.

{{Film date|1993|02|24|df=y}} returns:

24 February 1993 (1993-02-24)

{{Film date|1993|02|24|Latvia|df=y}} returns:

24 February 1993 (1993-02-24) (Latvia)

fy can be set to override the automatic category. For example:

{{Film date|1993|02|24||2008|03|23}} uses the category Category:1993 films

{{Film date|1993|02|24||2008|03|23|fy=2008}} uses the category Category:2008 films.

TV is to be used for television films. It sorts films into [[Category:YYYY television films]] in place of [[Category:YYYY films]]. Set TV=y or TV=yes to do this.

ref1, ref2, ref3, ref4, ref5 are used to supply named references. See above for detail.

Technical notes

Do not use any of the following markup in front of this template: : * #. Doing so will cause HTML errors. See MOS:INDENT for more guidance.

This template uses {{Start date}} to handle the hard work of date formatting, and {{Plainlist}} to format list items as recommended for use within infoboxes.

{{Film date|2001|1|28|location1|2002|2|28|location2}}

January 28, 2001 (2001-01-28) (location1)
February 28, 2002 (2002-02-28) (location2)

'"`UNIQ--templatestyles-00000021-QINU`"'<div class="plainlist " >
* January&nbsp;28,&nbsp;2001<span style="display:none">&#160;(<span class="bday dtstart published updated">2001-01-28</span>)</span>&#32;(location1)
* February&nbsp;28,&nbsp;2002<span style="display:none">&#160;(<span class="bday dtstart published updated">2002-02-28</span>)</span>&#32;(location2)

</div>

TemplateData

Displays information about a film's release date

Template parameters
This template prefers inline formatting of parameters.
Parameter		Description	Type	Status
Release year 1	`1`	no description	Number	required
Release month 1	`2`	no description	Unknown	suggested
Release day 1	`3`	no description	Number	suggested
Release location 1	`4`	First location where the film was released	Content	suggested
Release year 2	`5`	no description	Unknown	optional
Release month 2	`6`	no description	Unknown	optional
Release day 2	`7`	no description	Unknown	optional
Release location 2	`8`	no description	Unknown	optional
9	`9`	no description	Unknown	optional
10	`10`	no description	Unknown	optional
11	`11`	no description	Unknown	optional
12	`12`	no description	Unknown	optional
13	`13`	no description	Unknown	optional
14	`14`	no description	Unknown	optional
15	`15`	no description	Unknown	optional
16	`16`	no description	Unknown	optional
17	`17`	no description	Unknown	optional
18	`18`	no description	Unknown	optional
19	`19`	no description	Unknown	optional
20	`20`	no description	Unknown	optional
demospace	`demospace`	no description	Unknown	optional
TV	`TV`	Set to yes to apply TV categories	Boolean	optional
Category film year	`fy`	Sets the film year to be used in categorization	Number	optional
Day first?	`df`	Set to yes to display the day before the month	Boolean	optional
Reference 1	`ref1`	Reference for the film's first release date	Content	optional
Reference 2	`ref2`	Reference for the film's second release date	Content	optional
ref3	`ref3`	no description	Unknown	optional
ref4	`ref4`	no description	Unknown	optional
ref5	`ref5`	no description	Unknown	optional