View source for Module:TimeSpan

local TimeSpan = {}

local StringBuilder = require('Module:StringBuilder')

-- Metatable to make instances of TimeSpan readonly
local TimeSpan_mt = {
    __index = TimeSpan,
    __newindex = function()
        error("Attempt to modify readonly TimeSpan", 2)
    end
}

local MillisecondsPerSecond =	1000
local MillisecondsPerMinute =	60000
local MillisecondsPerHour = 	3600000
local MillisecondsPerDay =  	86400000
 
local SecondsPerMinute =		60
local SecondsPerHour =			3600
local SecondsPerDay =			86400
 
local MinutesPerHour =			60
local MinutesPerDay =			1440 
 
local HoursPerDay = 			24     

function TimeSpan.new(days, hours, minutes, seconds, milliseconds)
    local totalMilliseconds =  (days or 0)	  *	MillisecondsPerDay +
                               (hours or 0)   *	MillisecondsPerHour +
                               (minutes or 0) * MillisecondsPerMinute +
                               (seconds or 0) * MillisecondsPerSecond +
                               (milliseconds or 0)

    local self = {
        _totalMilliseconds = totalMilliseconds
    }

    setmetatable(self, TimeSpan_mt)
    return self
end

function TimeSpan.fromMilliseconds(milliseconds)
    return TimeSpan.new(0, 0, 0, 0, (milliseconds or 0))
end

function TimeSpan.fromSeconds(seconds)
    local totalMilliseconds = (seconds or 0) * MillisecondsPerSecond
    return TimeSpan.new(0, 0, 0, 0, totalMilliseconds)
end

function TimeSpan:getDays()
    return math.floor(self._totalMilliseconds / MillisecondsPerDay)
end

function TimeSpan:getHours()
    return math.floor(self._totalMilliseconds / MillisecondsPerHour % HoursPerDay)
end

function TimeSpan:getMinutes()
    return math.floor(self._totalMilliseconds / MillisecondsPerMinute % MinutesPerHour)
end

function TimeSpan:getSeconds()
    return math.floor(self._totalMilliseconds / MillisecondsPerSecond % SecondsPerMinute)
end

function TimeSpan:getMilliseconds()
    return math.floor(self._totalMilliseconds % MillisecondsPerSecond)
end

function TimeSpan:getTotalDays()
	return self._totalMilliseconds / MillisecondsPerDay
end

function TimeSpan:getTotalHours()
	return self._totalMilliseconds / MillisecondsPerHour
end

function TimeSpan:getTotalMinutes()
	return self._totalMilliseconds / MillisecondsPerMinute
end

function TimeSpan:getTotalSeconds()
	return self._totalMilliseconds / MillisecondsPerSecond
end

function TimeSpan:getTotalMilliseconds()
	return self._totalMilliseconds
end

function TimeSpan:toString()
	local sb = StringBuilder.new()
	local days = self:getDays()
	local hours = self:getHours()
	local minutes = self:getMinutes()
	local seconds = self:getSeconds()

    if days > 0 then
        sb:append(string.format("%d.", days))
    end
    
    sb:append(string.format("%02d:%02d:%02d", hours, minutes, seconds))
    
    if milliseconds > 0 then
        sb:append(string.format(".%03d", milliseconds))
    end

    return sb:toString()
end

function TimeSpan:toStringLong()
	-- Fast path if there's less than a minute's worth of time.
	local totalSeconds = self:getTotalSeconds()
	if totalSeconds < 60 then
		if math.floor(totalSeconds) == 0 then
			return string.format('0 seconds')
		end
		
		return string.format('%.1f seconds', totalSeconds)
	end

	-- Long path that outputs the entire TimeSpan
	local output = {}
	local days = self:getDays()
	local hours = self:getHours()
	local minutes = self:getMinutes()
	local seconds = self:getSeconds()
	local milliseconds = self:getMilliseconds()

	if days > 0 then
		table.insert(output, string.format('%d day%s', days, (days > 1) and "s" or ""))
	end
	if hours > 0 then
		table.insert(output, string.format('%d hour%s', hours, (hours > 1) and "s" or ""))
	end
	if minutes > 0 then
		table.insert(output, string.format('%d minute%s', minutes, (minutes > 1) and "s" or ""))
	end
	if seconds > 0 then
		table.insert(output, string.format('%d second%s', seconds, (seconds > 1) and "s" or ""))
	end
	if milliseconds > 0 then
		table.insert(output, string.format('%d milliseconds%s', milliseconds, (milliseconds > 1) and "s" or ""))
	end
	
	return table.concat(output, ", ")
end

function TimeSpan:__tostring()
    return self:toString()
end

return TimeSpan
Description	What you type	What you get
Italic	''Italic text''	Italic text
Bold	'''Bold text'''	Bold text
Bold & italic	'''''Bold & italic text'''''	*Bold & italic text*