Module:Date period

Module documentation[view] [edit] [history] [purge]

Usage

For templates, you might want to use {{Date period}} instead.

{{#invoke:Date period|_main|dateA|dateB}}

Automatically formats two given dates with a space and and en dash. Dates can be of any format supported by Module:Date.

If the month is the same, it is only shown once. If the month and day is the same, it will not show a second part at all. If the year is different, it will show the year unless disabled.

Date A	Date B	Output
2021-02-19	present
present	2021-02-25
2021-02-19	2021-02-25	February 19 – 25
2021-02-19	2021-03-25	February 19 – March 25
2020-02-19	2021-02-25	February 19, 2020 – February 25, 2021

The year can be forcefully shown with the force-year parameter (third parameter of p._main).

Date A	Date B	force-year	Output
2021-02-19	2021-02-25	no	February 19 – 25
2021-02-19	2021-02-25	yes	February 19 – 25
2020-02-19	2021-02-25	no	February 19, 2020 – February 25, 2021
2020-02-19	2021-02-25	yes	February 19, 2020 – February 25, 2021

If one of the dates is invalid, the raw text will be displayed instead.

Date A	Date B	Output
2021-02-19	Sometime far in the future.
Long ago	2021-02-25

The above documentation is transcluded from Module:Date period/doc. (edit | history)
Editors can experiment in this module's sandbox (create | mirror) and testcases (create) pages.
Subpages of this module.

local Date = require('Module:Date')._Date
local yesno = require('Module:Yesno')

local p = {}

function p.main(frame)
	return p._main(frame.args[1], frame.args[2], frame.args['no-year'])
end

function p._main(_dateA, _dateB, noYear)
	if _dateA == nil and _dateB == nil then
		error('Date A or B not provided.')
	elseif _dateA == nil then
		return Date(_dateA):text("%B %-d")
	elseif _dateB == nil then
		return Date(_dateB):text("%B %-d")
	end
	
	
	local dateA = Date(_dateA)
	local dateB = Date(_dateB)
	
	local showYear = dateA.year ~= dateB.year or yesno(noYear) == false
	
	if dateA.year == dateB.year then
		if dateA.month == dateB.month and dateA.day == dateB.day then
			return dateA:text("%B %-d")
		elseif dateA.month == dateB.month then
			return dateA:text("%B %-d") .. " – " .. dateB.day .. (showYear and (", " .. dateA.year) or "")
		else
			return dateA:text("%B %-d") .. " – " .. dateB:text("%B %-d") .. (showYear and (", " .. dateA.year) or "")
		end
	else
		return dateA:text("%B %-d, %-Y") .. " – " .. dateB:text("%B %-d, %-Y")
	end
	
end

return p