Difference between revisions of "Module:Time ago"

From blackwiki
Jump to navigation Jump to search
blackwiki>FunPika
(Try to simplify all of the elseifs.)
blackwiki>FunPika
(Cleanup and commenting.)
Line 5: Line 5:
  
 
function p.timeAgo( frame )
 
function p.timeAgo( frame )
 +
-- Initialize variables
 
local lang = mw.language.getContentLanguage()
 
local lang = mw.language.getContentLanguage()
 +
local auto_magnitude_num
 +
local min_magnitude_num
 +
local result
 +
local magnitude = frame.args.magnitude
 +
local min_magnitude = frame.args.min_magnitude
 +
if frame.args.ago then ago = frame.args.ago else ago = 'ago' end
 
local purge = ''
 
local purge = ''
+
 
 +
-- Add a purge link if something (usually "yes") is entered into the purge parameter
 
if ( frame.args.purge ) then
 
if ( frame.args.purge ) then
 
local builder = HtmlBuilder.create()
 
local builder = HtmlBuilder.create()
Line 16: Line 24:
 
.wikitext('([' .. mw.title.getCurrentTitle():fullUrl('action=purge') .. ' purge])')
 
.wikitext('([' .. mw.title.getCurrentTitle():fullUrl('action=purge') .. ' purge])')
 
.done()
 
.done()
+
 
 
purge = tostring(builder)
 
purge = tostring(builder)
 
end
 
end
+
 
 +
-- Check that the entered timestamp is valid. If it isn't, then give an error message.
 
local noError, inputTime = pcall( lang.formatDate, lang, 'U', frame.args[1] )
 
local noError, inputTime = pcall( lang.formatDate, lang, 'U', frame.args[1] )
if not noError then  
+
if not noError then
 
local builder = HtmlBuilder.create()
 
local builder = HtmlBuilder.create()
 
builder
 
builder
Line 28: Line 37:
 
.wikitext('Error: first parameter cannot be parsed as a date or time.')
 
.wikitext('Error: first parameter cannot be parsed as a date or time.')
 
.done()
 
.done()
+
 
return tostring(builder) .. purge  
+
return tostring(builder) .. purge
 
end
 
end
+
 
 +
-- Store the difference between the current time and the inputted time, as well as its absolute value.
 
local timeDiff = lang:formatDate( 'U' ) - inputTime
 
local timeDiff = lang:formatDate( 'U' ) - inputTime
 
local absTimeDiff = math.abs( timeDiff )
 
local absTimeDiff = math.abs( timeDiff )
local magnitude = frame.args.magnitude
+
 
local min_magnitude = frame.args.min_magnitude
 
local auto_magnitude_num
 
local min_magnitude_num
 
local result
 
if frame.args.ago then ago = frame.args.ago else ago = 'ago' end
 
 
 
if magnitude then
 
if magnitude then
 
auto_magnitude_num = 0
 
auto_magnitude_num = 0
Line 52: Line 56:
 
if min_magnitude then min_magnitude_num = timeText[min_magnitude] else min_magnitude_num = -1 end
 
if min_magnitude then min_magnitude_num = timeText[min_magnitude] else min_magnitude_num = -1 end
 
end
 
end
+
 
if not min_magnitude_num then min_magnitude_num = 1 end
+
if not min_magnitude_num then min_magnitude_num = 1 end -- Default to seconds if an invalid magnitude is entered.
local magnitude_num = math.max( min_magnitude_num, auto_magnitude_num )  
+
 
 +
local magnitude_num = math.max( min_magnitude_num, auto_magnitude_num )
 
local result_num = math.floor ( absTimeDiff / magnitude_num )
 
local result_num = math.floor ( absTimeDiff / magnitude_num )
 
local result_unit
 
local result_unit
if ( timeDiff >= 0 ) then
+
 
 +
if ( timeDiff >= 0 ) then -- Past
 
if result_num == 1 then result_unit = timeUnits[ magnitude_num ][1] else result_unit = timeUnits[ magnitude_num ][2] end
 
if result_num == 1 then result_unit = timeUnits[ magnitude_num ][1] else result_unit = timeUnits[ magnitude_num ][2] end
 
result = result_num .. ' ' .. result_unit .. ' ' .. ago
 
result = result_num .. ' ' .. result_unit .. ' ' .. ago
else
+
else -- Future
if result_num == 1 then result_unit = timeUnits[ magnitude_num ][3] else result_unit = timeUnits[ magnitude_num ][4] end
+
if result_num == 1 then result_unit = timeUnits[ magnitude_num ][3] else result_unit = timeUnits[ magnitude_num ][4] end
 
result = result_num .. ' ' .. result_unit .. ' time'
 
result = result_num .. ' ' .. result_unit .. ' time'
 
end
 
end
 +
 
return result .. purge
 
return result .. purge
 
end
 
end
  
 +
-- Table to convert entered text values to numeric values.
 
timeText = {
 
timeText = {
["seconds"] = 1,
+
['seconds'] = 1,
["minutes"] = 60,
+
['minutes'] = 60,
["hours"] = 3600,
+
['hours'] = 3600,
["days"] = 86400,
+
['days'] = 86400,
["weeks"] = 604800,
+
['weeks'] = 604800,
["months"] = 2678400,
+
['months'] = 2678400,
["years"] = 31557600,
+
['years'] = 31557600
 
}
 
}
  
 +
-- Table containing tables of possible units to use in output.
 
timeUnits = {
 
timeUnits = {
 
[1] = { 'second', 'seconds', 'second\'s', 'seconds\'' },
 
[1] = { 'second', 'seconds', 'second\'s', 'seconds\'' },
Line 84: Line 93:
 
[604800] = { 'week', 'weeks', 'week\'s', 'weeks\'' },
 
[604800] = { 'week', 'weeks', 'week\'s', 'weeks\'' },
 
[2678400] = { 'month', 'months', 'month\'s', 'months\'' },
 
[2678400] = { 'month', 'months', 'month\'s', 'months\'' },
[31557600] = { 'year', 'years', 'year\'s', 'years\'' },
+
[31557600] = { 'year', 'years', 'year\'s', 'years\'' }
 
}
 
}
  
 
return p
 
return p

Revision as of 21:15, 21 December 2013

The module “Time ago” implements {{Time ago}}. See the template's page for documentation. Test cases can be found at Module talk:TimeAgo/testcases and Template:Time ago/testcases.


-- Replacement for [[Template:Time ago]]
local HtmlBuilder = require('Module:HtmlBuilder')

local p = {}

function p.timeAgo( frame )
	-- Initialize variables
	local lang = mw.language.getContentLanguage()
	local auto_magnitude_num
	local min_magnitude_num
	local result
	local magnitude = frame.args.magnitude
	local min_magnitude = frame.args.min_magnitude
	if frame.args.ago then ago = frame.args.ago else ago = 'ago' end
	local purge = ''

	-- Add a purge link if something (usually "yes") is entered into the purge parameter
	if ( frame.args.purge ) then
		local builder = HtmlBuilder.create()
		builder
			.wikitext(' ')
			.tag('span')
				.addClass('plainlinks')
				.wikitext('([' .. mw.title.getCurrentTitle():fullUrl('action=purge') .. ' purge])')
				.done()

		purge = tostring(builder)
	end

	-- Check that the entered timestamp is valid. If it isn't, then give an error message.
	local noError, inputTime = pcall( lang.formatDate, lang, 'U', frame.args[1] )
	if not noError then
		local builder = HtmlBuilder.create()
		builder
			.tag('strong')
				.addClass('error')
				.wikitext('Error: first parameter cannot be parsed as a date or time.')
				.done()

		return tostring(builder) .. purge
	end

	-- Store the difference between the current time and the inputted time, as well as its absolute value.
	local timeDiff = lang:formatDate( 'U' ) - inputTime
	local absTimeDiff = math.abs( timeDiff )

	if magnitude then
		auto_magnitude_num = 0
		min_magnitude_num = timeText[magnitude]
	else
		if ( math.floor( absTimeDiff / 120 ) > 0 ) then auto_magnitude_num = 60 else auto_magnitude_num = 1 end
		if ( math.floor( absTimeDiff / 7200 ) > 0 ) then auto_magnitude_num = 3600 end
		if ( math.floor( absTimeDiff / 172800 ) > 0 ) then auto_magnitude_num = 86400 end
		if ( math.floor( absTimeDiff / 5356800 ) > 0 ) then auto_magnitude_num = 2678400 end
		if ( math.floor( absTimeDiff / 63115200 ) > 0 ) then auto_magnitude_num = 31557600 end
		if min_magnitude then min_magnitude_num = timeText[min_magnitude] else min_magnitude_num = -1 end
	end

	if not min_magnitude_num then min_magnitude_num = 1 end -- Default to seconds if an invalid magnitude is entered.

	local magnitude_num = math.max( min_magnitude_num, auto_magnitude_num )
	local result_num = math.floor ( absTimeDiff / magnitude_num )
	local result_unit

	if ( timeDiff >= 0 ) then -- Past
		if result_num == 1 then result_unit = timeUnits[ magnitude_num ][1] else result_unit = timeUnits[ magnitude_num ][2] end
		result = result_num .. ' ' .. result_unit .. ' ' .. ago
	else -- Future
		if result_num == 1 then result_unit = timeUnits[ magnitude_num ][3] else result_unit = timeUnits[ magnitude_num ][4] end
		result = result_num .. ' ' .. result_unit .. ' time'
	end

	return result .. purge
end

-- Table to convert entered text values to numeric values.
timeText = {
	['seconds'] = 1,
	['minutes'] = 60,
	['hours'] = 3600,
	['days'] = 86400,
	['weeks'] = 604800,
	['months'] = 2678400,
	['years'] = 31557600
}

-- Table containing tables of possible units to use in output.
timeUnits = {
	[1] = { 'second', 'seconds', 'second\'s', 'seconds\'' },
	[60] = { 'minute', 'minutes', 'minute\'s', 'minutes\'' },
	[3600] = { 'hour', 'hours', 'hour\'s', 'hours\'' },
	[86400] = { 'day', 'days', 'day\'s', 'days\'' },
	[604800] = { 'week', 'weeks', 'week\'s', 'weeks\'' },
	[2678400] = { 'month', 'months', 'month\'s', 'months\'' },
	[31557600] = { 'year', 'years', 'year\'s', 'years\'' }
}

return p