Modul:DateTime
local DateTime = { serial = "2019-10-21",
suite = "DateTime", item = 20652535 }
-- Date and time objects local Failsafe = DateTime local GlobalMod = DateTime local Calc = { } local Meta = { } local Parser = { } local Private = { } local Prototypes = { } local Templates = { } local World = { slang = "en",
monthsLong = { }, monthsParse = { }, months4 = { } }
local MaxYear = 2099 local Nbsp = mw.ustring.char( 160 ) local Tab = mw.ustring.char( 9 ) local Frame World.era = { en = { "BC", "AD" } } World.monthsAbbr = { en = { n = 3 } } World.monthsLong.en = { "January",
"February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" }
World.monthsParse.en = { [ "Apr" ] = 4,
[ "Aug" ] = 8, [ "Dec" ] = 12, [ "Feb" ] = 2, [ "Jan" ] = 1, [ "Jul" ] = 7, [ "Jun" ] = 6, [ "Mar" ] = 3, [ "May" ] = 5, [ "Nov" ] = 11, [ "Oct" ] = 10, [ "Sep" ] = 9 }
World.months4.en = { [ 6 ] = true,
[ 7 ] = true }
World.templates = { [ "ISO" ] =
{ spec = "Y-m-d", lift = true }, [ "ISO-T" ] = { spec = "c" }, [ "timestamp" ] = { spec = "YmdHis" }, [ "default" ] = { spec = "H:i, j M Y", long = true }, [ "$dmy" ] = { spec = "H:i, j M Y", long = true }, [ "$ymd" ] = { spec = "H:i, Y M j", long = true }, [ "$dmyt" ] = { spec = "j M Y, H:i", long = true }, [ "$dmyts" ] = { spec = "j M Y, H:i:s", long = true }, [ "data-sort-type:date" ] = { spec = "j M Y" } }
World.templates.en = { } World.zones = {
[ "!" ] = "YXWVUTSRQPONZABCDEFGHIKLM", UTC = 0, GMT = 0 -- Greenwich Mean Time
} World.zones.en = {
BST = 100, -- British Summer Time IST = 100, -- Irish Summer Time WET = 0, -- Western Europe Time WEST = 100, -- Western Europe Summer Time CET = 100, -- Central Europe Time CEST = 200, -- Central Europe Summer Time EET = 200, -- Eastern Europe Time EEST = 300, -- Eastern Europe Summer Time MSK = 300, -- Moscow Time MSD = 400, -- Moscow Summer Time NST = -330, -- Newfoundland Standard Time NDT = -230, -- Newfoundland Daylight Time AST = -400, -- Atlantic Standard Time ADT = -300, -- Atlantic Daylight Time EST = -500, -- Eastern Standard Time EDT = -400, -- Eastern Daylight Saving Time CST = -600, -- Central Standard Time CDT = -500, -- Central Daylight Saving Time MST = -700, -- Mountain Standard Time MDT = -600, -- Mountain Daylight Saving Time PST = -800, -- Pacific Standard Time PDT = -700, -- Pacific Daylight Saving Time AKST = -900, -- Alaska Standard Time AKDT = -800, -- Alaska Standard Daylight Saving Time HST = -1000 -- Hawaiian Standard Time
}
local foreignModule = function ( access, advanced, append, alt, alert )
-- Fetch global module -- Precondition: -- access -- string, with name of base module -- advanced -- true, for require(); else mw.loadData() -- append -- string, with subpage part, if any; or false -- alt -- number, of wikidata item of root; or false -- alert -- true, for throwing error on data problem -- Postcondition: -- Returns whatever, probably table -- 2019-10-20 local storage = access local fun, lucky, r if advanced then fun = require else fun = mw.loadData end if append then storage = string.format( "%s/%s", storage, append ) end lucky, r = pcall( fun, "Module:" .. storage ) if not lucky then local suited GlobalMod.globalModules = GlobalMod.globalModules or { } suited = GlobalMod.globalModules[ access ] if not suited and type( alt ) == "number" and alt > 0 then suited = string.format( "Q%d", alt ) suited = mw.wikibase.getSitelink( suited ) GlobalMod.globalModules[ access ] = suited or true end if type( suited ) == "string" then storage = suited if append then storage = string.format( "%s/%s", storage, append ) end lucky, r = pcall( fun, storage ) end if not lucky and alert then error( "Missing or invalid page: " .. storage, 0 ) end end return r
end -- foreignModule()
local function capitalize( a )
-- Upcase first character, downcase anything else -- Parameter: -- a -- string -- Returns: -- string return mw.ustring.upper( mw.ustring.sub( a, 1, 1 ) ) .. mw.ustring.lower( mw.ustring.sub( a, 2 ) )
end -- capitalize()
local function fault( a )
-- Format error message by class=error -- Parameter: -- a -- string, error message -- Returns: -- string, HTML span local e = mw.html.create( "span" ) :addClass( "error" ) :wikitext( a ) return tostring( e )
end -- fault()
local function frame()
if not Frame then Frame = mw.getCurrentFrame() end return Frame
end -- frame()
Meta.localized = false Meta.serial = DateTime.serial Meta.signature = "__datetime" Meta.suite = "{DateTime}" Meta.components = { lang = "string",
bc = "boolean", year = "number", month = "number", week = "number", dom = "number", hour = "number", min = "number", sec = "number", msec = "number", mysec = "number", zone = false, leap = "boolean", jul = "boolean" }
Meta.order = { "bc", "year", "month", "week", "dom",
"hour", "min", "sec", "msec", "mysec" }
Meta.tableI = { -- instance metatable
__index = function ( self, access ) local r = self[ Meta.signature ][ access ] if r == nil then if access == "serial" then r = Meta.serial elseif access == "suite" then r = "DateTime" else r = Prototypes[ access ] end end return r end, __newindex = function ( self, access, assign ) if type( access ) == "string" then local data = self[ Meta.signature ] if assign == nil then local val = data[ access ] data[ access ] = nil if not Prototypes.fair( data ) then data[ access ] = val end elseif Prototypes.fair( data, access, assign ) then data[ access ] = assign end end return end, __add = function ( op1, op2 ) return Prototypes.future( op1, op2, true ) end, __eq = function ( op1, op2 ) return Prototypes.flow( op1, op2, "eq" ) end, __lt = function ( op1, op2 ) return Prototypes.flow( op1, op2, "lt" ) end, __le = function ( op1, op2 ) return Prototypes.flow( op1, op2, "le" ) end, __tostring = function ( e ) return Prototypes.tostring( e ) end, __call = function ( func, ... ) return Meta.fiat( ... ) end
} -- Meta.tableI Meta.tableL = { -- library metatable
__index = function ( self, access ) local r if access == "serial" then r = Meta.serial elseif access == "suite" then r = Meta.suite end return r end, __newindex = function () return end, __tostring = function () return Meta.suite end, __call = function ( func, ... ) return Meta.fiat( ... ) end
} -- Meta.tableL Meta.fiat = function ( assign, alien, add )
-- Create instance object (constructor) -- Parameter: -- assign -- string, with initial timestamp, or nil -- nil -- now -- false -- empty object -- table -- clone this object, or copy from raw -- ignore remaining parameters -- alien -- string, with language code, or nil -- add -- string, with interval (PHP strtotime), or nil -- Returns: -- table, as DateTime object -- string or false, if failed local r Private.foreign() if type( assign ) == "table" then if assign.suite == Meta.suite and getmetatable( assign ) == Meta.tableI then r = assign[ Meta.signature ] else r = Private.from( assign ) end else r = Private.factory( assign, alien, add ) end if type( r ) == "table" then r = { [ Meta.signature ] = r } setmetatable( r, Meta.tableI ) end return r
end -- Meta.fiat() setmetatable( DateTime, Meta.tableL ) DateTime.serial = nil
Calc.months = { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }
-- Calc.fast = function ( at ) -- -- Quick scan of full ISO stamp -- -- Parameter: -- -- apply -- string, ISO -- -- Returns: -- -- table, with numeric components -- local r = { } -- r.year = tonumber( at:sub( 1, 4 ) ) -- r.month = tonumber( at:sub( 6, 2 ) ) -- r.dom = tonumber( at:sub( 9, 2 ) ) -- r.hour = tonumber( at:sub( 12, 2 ) ) -- r.min = tonumber( at:sub( 14, 2 ) ) -- r.sec = tonumber( at:sub( 17, 2 ) ) -- if at:sub( 19, 1 ) == "." then -- r.msec = tonumber( at:sub( 20, 3 ) ) -- if #at > 22 then -- r.mysec = tonumber( at:sub( 23, 3 ) ) -- end -- end -- return r -- end -- Calc.fast()
Calc.fair = function ( adjust )
-- Normalize numeric components -- Parameter: -- adjust -- table, with raw numbers local ranges = { year = { min = -999, max = 9999 }, month = { min = 1, max = 12, mod = 12 }, dom = { min = 1, max = 28 }, hour = { mod = 24 }, min = { mod = 60 }, sec = { mod = 60 }, msec = { mod = 1000 }, mysec = { mod = 1000 } } local m, max, min, move, n, range, s for i = 10, 2, -1 do s = Meta.order[ i ] n = adjust[ s ] if n or move then range = ranges[ s ] if range then min = range.min or 0 max = range.max or ( range.mod - 1 ) if move then n = ( n or 0 ) + move move = false end if n < min or n > max then if range.mod then m = n % range.mod move = ( n - m ) / range.mod n = min + m else -- dom if adjust.month and adjust.year and adjust.month >= 1 and adjust.month <= 12 and adjust.year > 1900 then if n > 0 then max = Calc.final( adjust ) while n > max do n = n - max if adjust.month < 12 then adjust.month = adjust.month + 1 else adjust.month = 1 adjust.year = adjust.year + 1 end max = Calc.final( adjust ) end -- while n <= max else while n < 1 do if adjust.month == 1 then adjust.month = 12 adjust.year = adjust.year - 1 else adjust.month = adjust.month - 1 end max = Calc.final( adjust ) n = n + max end -- while n < 1 end end end end adjust[ s ] = n end end end -- for i
end -- Calc.fair()
Calc.final = function ( adjust )
-- Retrieve number of days in particular month -- Parameter: -- adjust -- table, with date specification -- Returns: -- number, of days in month local r = Calc.months[ adjust.month ] if adjust.month == 2 and ( adjust.year % 4 ~= 0 or adjust.year % 400 == 0 ) then r = 28 end return r
end -- Calc.final()
Calc.future = function ( add )
-- Parse move interval -- Parameter: -- add -- string, with GNU relative items -- Returns: -- table, with numeric components, or false local r, token local units = { year = true, month = true, fortnight = { slot = "dom", mult = 14 }, week = { slot = "dom", mult = 7 }, dom = true, hour = true, min = true, sec = true } local story = string.format( " %s ", add:lower() ) :gsub( "%s+", " " ) :gsub( " yesterday ", " -1 dom " ) :gsub( " tomorrow ", " 1 dom " ) :gsub( "(%l)s ", "%1 " ) :gsub( " day ", " dom " ) :gsub( " minute ", " min " ) :gsub( " second ", " sec " ) local feed = function () local slice token, slice = story:match( "^( (%S+)) " ) return slice end local fed = function () story = story:sub( #token + 1 ) end local m, n, s, u while true do s = feed() if s then n = 1 if s:match( "^[+-]?%d+$" ) then n = tonumber( s ) fed() s = feed() end if s then u = units[ s ] end if s and u then fed() if u ~= true then s = u.slot n = n * u.mult end if feed() == "ago" then if n > 0 then n = - n end fed() end r = r or { } r[ s ] = ( r[ s ] or 0 ) + n else r = false break -- while true end else break -- while true end end -- while true return r
end -- Calc.future()
Parser.digitsHeading = function ( analyse, alone, amount, add )
-- String analysis, if digits only or at least 4 digits heading -- Parameter: -- analyse -- string to be scanned, starting with digit -- digits only, else starting with exactly 4 digits -- alone -- true, if only digits -- amount -- number of heading digits -- add -- table, to be extended -- Returns: -- table, extended if parsed -- false, if invalid text format local r = add if alone then -- digits only if amount <= 4 then r.year = tonumber( analyse ) elseif n == 14 then -- timestamp r.year = tonumber( analyse:sub( 1, 4 ) ) r.month = tonumber( analyse:sub( 5, 2 ) ) r.dom = tonumber( analyse:sub( 7, 2 ) ) r.hour = tonumber( analyse:sub( 9, 2 ) ) r.min = tonumber( analyse:sub( 11, 2 ) ) r.sec = tonumber( analyse:sub( 13, 2 ) ) else r = false end elseif amount == 4 then local s, sep, sx = analyse:match( "^(%d+)([%-%.:Ww]?)(.*)$" ) r.year = tonumber( s ) if sep == "-" then -- ISO s, sep, sx = sx:match( "^(%d%d)(-?)(.*)$" ) if s then r.month = tonumber( s ) r.month2 = true if sep == "-" then s, sep, sx = sx:match( "^(%d%d?)([ T]?)(.*)$" ) if s then r.dom = tonumber( s ) if sep == "T" then r.month2 = nil else r.dom2 = ( #s == 2 ) end if sep then r = Parser.time( sx, r, sep == "T" ) end else r = false end elseif sx and sx ~= "" then r = false end else r = false end elseif sep:lower() == "w" then if sx then s = sx:match( "^(%d%d?)$" ) if s then r.week = tonumber( s ) if r.week < 1 or r.week > 53 then r = false end else r = false end else r = false end else r = false end if r then r.iso = true end elseif amount == 8 then -- ISO compact local s, sz = analyse:match( "^%d+T(%d+)([.+-]?%d*%a*)$" ) if s then local n = #s if n == 2 or n == 4 or n == 6 then r.year = tonumber( analyse:sub( 1, 4 ) ) r.month = tonumber( analyse:sub( 5, 6 ) ) r.dom = tonumber( analyse:sub( 7, 8 ) ) r.hour = tonumber( analyse:sub( 10, 11 ) ) if n > 2 then r.min = tonumber( s:sub( 3, 4 ) ) if n == 6 then r.sec = tonumber( s:sub( 5, 6 ) ) end n, s = sz:match( "^(%.%d+)([+-]?[%a%d]*)$" ) if n then n = n .. "00" r.msec = tonumber( n:sub( 1, 3 ) ) if #n >= 6 then r.mysec = tonumber( n:sub( 4, 6 ) ) end sz = s end end if sz ~= "" then s, sz = sz:match( "^([+-]?)(%a*)$" ) if s == "" then if sz:match( "^(%u)$" ) then r.zone = sz else s = false end elseif #s == 1 then r.zone = s .. sz else s = false end end else s = false end end if s then r = false end end return r
end -- Parser.digitsHeading()
Parser.eraGermanEnglish = function ( analyse )
-- String analysis, for German and English era -- v. Chr. v. u. Z. n. Chr. AD BC A.D. B.C. B.C.E. -- Parameter: -- analyse -- string -- Returns: -- 1 -- table, with boolean era, if any -- 2 -- string, with era stripped off, if any local rO = { } local rS = analyse local s, switch = analyse:match( "^(.+) ([vn])%. ?Chr%.$" ) if switch then rS = s rO.bc = ( switch == "v" ) elseif analyse:find( " v%. ?u%. ?Z%.$" ) then rS = analyse:match( "^(.+) v%. ?u%. ?Z%.$" ) rO.bc = true elseif analyse:find( " B%.? ?C%.? ?E?%.?$" ) then rS = analyse:match( "^(.+) B%.? ?C%.? ?E?%.?$" ) rO.bc = true elseif analyse:find( "^A%.? ?D%.? " ) then rS = analyse:match( "^A%.? ?D%.? (.*)$" ) rO.bc = false end return rO, rS
end -- Parser.eraGermanEnglish()
Parser.european = function ( ahead, adhere, analyse, assign )
-- String analysis, retrieve date style: DOM MONTH YEAR -- Parameter: -- ahead -- string, with first digits, not more than 2 -- adhere -- string, with first separator; not ":" -- analyse -- string, remainder following adhere -- assign -- table -- Returns: -- table, extended if parsed local r = assign local s, s2, sx if adhere == "." or adhere == ". " then -- 23.12.2013 -- 23. Dezember 2013 s, sx = analyse:match( "^(%d%d?)%.(.*)$" ) if s then r = Parser.putDate( false, s, ahead, assign ) r = Parser.yearTime( sx, r ) else s, sx = mw.ustring.match( analyse, "^ ?([%a&;]+%.?) ?(.*)$" ) if s then local n = Parser.monthNumber( s ) if n then r.month = n r.dom = tonumber( ahead ) r.dom2 = ( #ahead == 2 ) r = Parser.yearTime( sx, r ) else r = false end else r = false end end elseif adhere == " " then -- 23 Dec 2013 s, sx = mw.ustring.match( analyse, "^([%a&;]+%.?) ?(.*)$" ) if s then local n = Parser.monthNumber( s ) if n then r.month = n r.dom = tonumber( ahead ) r.dom2 = ( #ahead == 2 ) r = Parser.yearTime( sx, r ) else r = false end else r = false end else r = false end return r
end -- Parser.european()
Parser.isoDate = function ( analyse, assign )
-- String analysis, retrieve month heading ISO date -- Parameter: -- analyse -- string, with heading hyphen -- assign -- table -- Returns: -- 1 -- table, extended if parsed -- 2 -- stripped string, or false, if invalid text format local rO, rS if analyse:match( "^%-%-?[0-9]" ) then local n, s rO = assign rS = analyse:sub( 2 ) s = rS:match( "^([012][0-9])%-" ) if s then n = tonumber( s ) if n >= 1 and n <= 12 then rO.month = n rS = rS:sub( 3 ) else rO = false end end if rO then if rS:byte( 1, 1 ) == 45 then local suffix s = rS:match( "^%-([012][0-9])" ) if s then n = tonumber( s ) if n >= 1 and n <= 31 then rO.dom = n rS = rS:sub( 4 ) else rO = false end else rS:sub( 2 ) end else rO = false end if rO then if #rS > 0 then if rO.dom then n = rS:byte( 1, 1 ) if n == 32 or n == 84 then rS = rS:sub( 2 ) else rO = false end else rO = false end end end end else rO = false end if rO then rO.iso = true else rS = false end return rO, rS
end -- Parser.isoDate()
Parser.monthHeading = function ( analyse, assign )
-- String analysis, retrieve month heading date (US only) -- Parameter: -- analyse -- string, with heading word -- assign -- table -- Returns: -- 1 -- table, extended if parsed -- 2 -- stripped string, or false, if invalid text format local rO = assign local rS = analyse local s, sep = mw.ustring.match( analyse, "^([%a&;]+%.?)([^%a%.]?)" ) if s then -- might begin with month name "December 23, 2013" local n = Parser.monthNumber( s ) if n then rO.month = n if sep == "" then rS = "" else local s2, s3 n = mw.ustring.len( s ) + 1 s = mw.ustring.sub( analyse, n ) s2 = s:match( "^ (%d%d%d?%d?)$" ) if s2 then rO.year = tonumber( s2 ) rS = "" else s2, s3, rS = s:match( "^ (%d+), (%d+)( ?.*)$" ) if s2 and s3 then n = #s2 if n <= 2 and #s3 == 4 then rO.dom = tonumber( s2 ) rO.year = tonumber( s3 ) rO.dom2 = ( n == 2 ) else rO = false end else rO = false end end end else rO = false end else rO = false end if not rO then rS = false end return rO, rS
end -- Parser.monthHeading()
Parser.monthNumber = function ( analyse )
-- String analysis, retrieve month number -- Parameter: -- analyse -- string, with month name including any period -- Returns: -- number, 1...12 if found -- false or nil, if not detected local r = false local s = mw.ustring.match( analyse, "^([%a&;]+)%.?$" ) if s then local given s = capitalize( s ) for k, v in pairs( World.monthsLong ) do given = World.monthsParse[ k ] if given then r = given[ s ] end if not r then given = World.monthsLong[ k ] for i = 1, 12 do if given[ i ] == s then r = i break end end -- for i end if r then break end end -- for k, v end return r
end -- Parser.monthNumber()
Parser.putDate = function ( aYear, aMonth, aDom, assign )
-- Store date strings -- Parameter: -- aYear -- string, with year, or false -- aMonth -- string, with numeric month -- aDom -- string, with day of month -- assign -- table -- Returns: -- table, extended local r = assign if aYear then r.year = tonumber( aYear ) end r.month = tonumber( aMonth ) r.dom = tonumber( aDom ) r.month2 = ( #aMonth == 2 ) r.dom2 = ( #aDom == 2 ) return r
end -- Parser.putDate()
Parser.time = function ( analyse, assign, adjusted )
-- String analysis, retrieve time components -- Parameter: -- analyse -- string, with time part -- assign -- table -- adjusted -- true: fixed length of 2 digits expected -- Returns: -- table, extended if parsed -- false, if invalid text format local r = assign if analyse ~= "" then local s, sx = analyse:match( "^(%d+)(:?.*)$" ) if s then local n = #s if n <= 2 then r.hour = tonumber( s ) if not adjusted then r.hour2 = ( n == 2 ) end else sx = false r = false end if sx then s, sx = sx:match( "^:(%d+)(:?(.*))$" ) if s then if #s == 2 then r.min = tonumber( s ) if sx == "" then sx = false end else sx = false r = false end if sx then local sep local scan = "^([:,] ?)(%d+)(.*)$" sep, s, sx = sx:match( scan ) if sep == ":" then if #s == 2 then r.sec = tonumber( s ) end elseif sep == ", " then r = Parser.wikiDate( s .. sx, r ) sx = false else r = false end end else r = false end end if sx and sx ~= "" then s = sx:match( "^%.(%d+)$" ) if s then s = s .. "00" r.msec = tonumber( s:sub( 1, 3 ) ) if #s >= 6 then r.mysec = tonumber( s:sub( 4, 6 ) ) end else r = false end end else r = false end end return r
end -- Parser.time()
Parser.wikiDate = function ( analyse, assign )
-- String analysis, for date after wiki ~~~~~ signature time -- dmy 10:28, 30. Dez. 2013 -- ymd 10:28, 2013 Dez. 30 -- Parameter: -- analyse -- string -- assign -- table -- Returns: -- table, extended if parsed -- false, if invalid text format local r local s = analyse:match( "^(2%d%d%d) " ) local sx if s then -- ymd "10:28, 2013 Dez. 30" local n = false r = assign r.year = tonumber( s ) s = analyse:sub( 6 ) s, sx = mw.ustring.match( analyse:sub( 6 ), "^([%a&;]+)%.? (%d%d?)$" ) if s then n = Parser.monthNumber( s ) if n then r.month = n end end if n then r.dom = tonumber( sx ) r.dom2 = ( #sx == 2 ) else r = false end else -- dmy "10:28, 30. Dez. 2013" local sep s, sep, sx = analyse:match( "^(%d%d?)(%.? ?)(%a.+)$" ) if s then r = Parser.european( s, sep, sx, assign ) else r = false end end return r
end -- Parser.wikiDate()
Parser.yearTime = function ( analyse, assign )
-- String analysis, for possible year and possible time -- Parameter: -- analyse -- string, starting with year -- assign -- table -- Returns: -- table, extended if parsed -- false, if invalid text format local r = assign local n = #analyse if n > 0 then local s, sx if n == 4 then if analyse:match( "^%d%d%d%d$" ) then s = analyse sx = false end else s = analyse:match( "^(%d%d%d%d)[ ,]" ) if s then sx = analyse:sub( 5 ) else local suffix s, sx, suffix = analyse:match( "^(%d+)([ ,]?)(.*)$" ) if s then local j = #sx n = #s if n < 4 and ( j == 1 or #suffix == 0 ) then sx = analyse:sub( n + j ) else s = false end end end end if s then r.year = tonumber( s ) if sx then s, sx = sx:match( "^(,? ?)(%d.*)$" ) if #s >= 1 then r = Parser.time( sx, r ) end end else r = false end end return r
end -- Parser.yearTime()
Parser.zone = function ( analyse, assign )
-- String analysis, for time zone -- +/-nn +/-nnnn (AAAa) -- Parameter: -- analyse -- string -- assign -- table -- Returns: -- 1 -- table, with number or string zone, if any, or false -- 2 -- string, with zone stripped off, if any local rO = assign local rS = analyse local s, sign, shift, sub s = "^(.+)([+-])([01]%d):?(%d?%d?)$" s, sign, shift, sub = analyse:match( s ) if sign then if s:find( ":%d%d *$" ) then if sub then if #sub == 2 then rO.zone = tonumber( shift .. sub ) else rO = false end else rO.zone = tonumber( shift ) * 100 end if rO then if sign == "-" then rO.zone = - rO.zone end rS = mw.text.trim( s ) end end elseif analyse:find( "%(.*%)$" ) then s, shift = analyse:match( "^(.+)%((%a%a%a%a?)%)$" ) if shift then rO.zone = shift:upper() rS = mw.text.trim( s ) else rO = false end else s, shift = analyse:match( "^(.+%d) ?(%a+)$" ) if shift then local n = #shift if n == 1 then rO.zone = shift:upper() elseif n == 3 then if shift == "UTC" or shift == "GMT" then rO.zone = 0 end end if rO.zone then rS = s end end end return rO, rS
end -- Parser.zone()
Parser.GermanEnglish = function ( analyse )
-- String analysis, for German and English formats -- Parameter: -- analyse -- string, with date or time or parts of it -- Returns: -- table, if parsed -- false, if invalid text format local r, s = Parser.eraGermanEnglish( analyse ) r, s = Parser.zone( s, r ) if r then local start, sep, sx = s:match( "^(%d+)([ %-%.:WwT]?)(.*)$" ) if start then -- begins with one or more digits (ASCII) local n = #start local lazy = ( start == s and ( n >=4 or type( r.bc == "boolean" ) ) ) if n == 4 or n == 8 or lazy then r = Parser.digitsHeading( s, lazy, n, r ) elseif n <= 2 then if sep == ":" then r, s = Parser.time( s, r ) elseif sep == "" then r = false else r = Parser.european( start, sep, sx, r ) end else r = false end else local rM, sM = Parser.monthHeading( s, r ) if rM then r = rM else r, sM = Parser.isoDate( s, r ) end if r and sM ~= "" then r = Parser.time( sM, r ) end end end return r
end -- Parser.GermanEnglish()
Private.factory = function ( assign, alien, add )
-- Create DateTime table (constructor) -- Parameter: -- assign -- string, with initial timestamp, or nil -- nil -- now -- false -- empty object -- alien -- string, with language code, or nil -- add -- string, with interval (PHP strtotime), or nil -- Returns: -- table, for DateTime object -- string or false, if failed local l = true local slang = mw.text.trim( alien or World.slang or "en" ) local r if assign == false then r = { } else local stamp = ( assign or "now" ) local shift if add then shift = Private.future( add ) end r = false if stamp == "now" then stamp = frame():callParserFunction( "#timel", "c", shift ) shift = false else local seconds = stamp:match( "^#(%d+)$" ) if seconds then stamp = os.date( "!%Y-%m-%dT%H:%M:%S", tonumber( seconds ) ) end end l, r = pcall( Private.fetch, stamp, slang, shift ) end if l and type( r ) == "table" then if slang ~= "" then r.lang = slang end end return r
end -- Private.factory()
Private.fetch = function ( analyse, alien, add )
-- Retrieve object from string -- Parameter: -- analyse -- string to be interpreted -- alien -- string with language code, or nil -- add -- table, with interval, or nil -- Returns: -- table, if parsed -- false, if invalid text format -- string, if serious error (args) local r if type( analyse ) == "string" then local strip = mw.ustring.char( 0x5B, 0x200E, 0x200F, 0x5D ) r = analyse:gsub( " ", " " ) :gsub( " ", " " ) :gsub( "&#x[aA]0;", " " ) :gsub( " ", " " ) :gsub( Nbsp, " " ) :gsub( Tab, " " ) :gsub( " +", " " ) :gsub( "%[%[", "" ) :gsub( "%]%]", "" ) :gsub( strip, "" ) r = mw.text.trim( r ) if r == "" then r = { } else local slang = ( alien or "" ) local parser = { en = "GermanEnglish", de = "GermanEnglish", frr = "GermanEnglish", nds = "GermanEnglish" } local suitable if slang == "" then slang = "en" else local s = slang:match( "^(%a+)%-" ) if s then slang = s end end slang = slang:lower() suitable = parser[ slang ] if suitable then local l l, r = pcall( Parser[ suitable ], r ) if l and r then if not Prototypes.fair( r ) then r = false elseif add then r = Prototypes.future( r, add ) end else r = "invalid format" end else r = "unknown language: " .. slang end end else r = "bad type" end return r
end -- Private.fetch()
Private.flow = function ( at1, at2 )
-- Compare two objects -- Parameter: -- at1 -- DateTime -- at2 -- DateTime -- Returns: -- -1, 0, 1 or nil if not comparable local r = 0 if at1.bc or at2.bc and at1.bc ~= at2.bc then if at1.bc then r = -1 else r = 1 end else local life = false local s, v1, v2 for i = 2, 10 do s = Meta.order[ i ] v1 = at1[ s ] v2 = at2[ s ] if v1 or v2 then if v1 and v2 then if v1 < v2 then r = -1 elseif v1 > v2 then r = 1 end elseif life then if v2 then r = -1 else r = 1 end else r = nil end if r ~= 0 then if at1.bc and r then r = r * -1 end break -- for i end life = true end end -- for i end return r
end -- Private.flow()
Private.foreign = function ()
-- Retrieve localization submodule if not Meta.localized then local d = foreignModule( DateTime.suite, false, "local", DateTime.item ) if d then local wk if d.slang then Meta.suite = string.format( "%s %s", Meta.suite, d.slang ) World.slang = d.slang end for k, v in pairs( d ) do wk = World[ k ] if wk and wk.en then for subk, subv in pairs( v ) do wk[ subk ] = subv end -- for k, v%s %s else World[ k ] = v end end -- for k, v end Meta.localized = true end
end -- Private.foreign()
Private.from = function ( attempt )
-- Create valid raw table from arbitrary table -- Parameter: -- attempt -- table, to be evaluated -- Returns: -- table, with valid components, or nil local data = { } local r for k, v in pairs( Meta.components ) do if v then v = ( type( attempt[ k ] ) == v ) else v = true end if v then data[ k ] = attempt[ k ] end end -- for k, v if Prototypes.fair( data ) then r = data end return r
end -- Private.from()
Private.future = function ( add )
-- Normalize move interval -- Parameter: -- add -- string or number, to be added -- Returns: -- table, with shift, or false/nil local r if add then local s = type( add ) if s == "string" and add:match( "^%s*[+-]?%d+%.?%d*%s*$" ) then r = tonumber( add ) s = "number" end if s == "number" then if r == 0 then r = false else r = string.format( "%d second", r or add ) end elseif s == "string" then r = add else r = false end if r then r = Calc.future( r ) end end return r
end -- Private.future()
Prototypes.clone = function ( self )
-- Clone object -- Parameter: -- self -- table, with object, to be cloned -- Returns: -- table, with object local r = { [ Meta.signature ] = self[ Meta.signature ] } setmetatable( r, Meta.tableI ) return r
end -- Prototypes.clone()
Prototypes.failsafe = function ( self, atleast )
-- Retrieve versioning and check for compliance -- Precondition: -- atleast -- string, with required version or "wikidata" or "~" -- or false -- Postcondition: -- Returns string -- with queried version, also if problem -- false -- if appropriate local last = ( atleast == "~" ) local since = atleast local r if last or since == "wikidata" then local item = Meta.item since = false if type( item ) == "number" and item > 0 then local entity = mw.wikibase.getEntity( string.format( "Q%d", item ) ) if type( entity ) == "table" then local seek = Failsafe.serialProperty or "P348" local vsn = entity:formatPropertyValues( seek ) if type( vsn ) == "table" and type( vsn.value ) == "string" and vsn.value ~= "" then if last and vsn.value == ( Meta.serial or DateTime.serial ) then r = false else r = vsn.value end end end end end if type( r ) == "nil" then if not since or since <= Meta.serial then r = Meta.serial else r = false end end return r
end -- Prototypes.failsafe()
Prototypes.fair = function ( self, access, assign )
-- Check formal validity of table -- Parameter: -- self -- table, to be checked -- access -- string or nil, single item to be checked -- assign -- single access value to be checked -- Returns: -- true, if valid; false, if not local r = ( type( self ) == "table" ) if r then local defs = { year = { max = MaxYear }, month = { min = 1, max = 12 }, week = { min = 1, max = 53 }, dom = { min = 1, max = 31 }, hour = { max = 23 }, min = { max = 59 }, sec = { max = 61 }, msec = { max = 999 }, mysec = { max = 999 } } local fNum = function ( k, v ) local ret = true local dk = defs[ k ] if dk then if type( dk.max ) == "number" then ret = ( type( v ) == "number" ) if ret then local min if dk.min then min = dk.min else min = 0 end ret = ( v >= min and v <= dk.max and math.floor( v ) == v ) if ret and dk.f then ret = dk.f( v ) end end end end return ret end -- fNum() defs.dom.f = function () local ret local d if access == "dom" then d = assign else d = self.dom end if d then ret = ( d <= 28 ) if not ret then local m if access == "month" then m = assign else m = self.month end if m then ret = ( d <= Calc.months[ m ] ) if ret then local y if access == "year" then y = assign else y = self.year end if d == 29 and m == 2 and y then if y % 4 ~= 0 or ( y % 100 == 0 and y % 400 ~= 0 ) then ret = false end end end end end else ret = true end return ret end -- defs.dom.f() defs.sec.f = function () local ret local second if access == "sec" then second = assign else second = self.sec end if second then ret = ( second <= 59 ) if not ret and self.leap then ret = true end end return ret end -- defs.sec.f() if access or assign then r = ( type( access ) == "string" ) if r then local def = defs[ access ] if def then r = fNum( access, assign ) if r then if def == "dom" or def == "month" or def == "year" then r = defs.dom.f() end end elseif access == "lang" then r = ( type( assign ) == "string" ) if r then r = assign:match( "^%l%l%l?-?%a*$" ) end elseif access == "london" then r = ( type( assign ) == "boolean" ) end end else local life = false local leak = false local s, v for i = 1, 10 do s = Meta.order[ i ] v = self[ s ] if v then if not life and leak then -- gap detected r = false break else if not fNum( s, v ) then r = false break -- for i end life = true leak = true end elseif i == 3 then if not self.week then life = false end elseif i ~= 4 then life = false end end -- for i if self.week and ( self.month or self.dom ) then r = false end end end return r
end -- Prototypes.fair()
Prototypes.figure = function ( self, assign )
-- Assign month by name -- Parameter: -- self -- table, to be filled -- assign -- string, with month name -- Returns: -- number 1...12, if valid; false, if not local r = false if type( self ) == "table" and type( assign ) == "string" then r = Parser.monthNumber( assign ) if r then self.month = r end end return r
end -- Prototypes.figure()
Prototypes.first = function ( self )
-- Retrieve abbreviated month name in current language -- Parameter: -- self -- table, to be evaluated -- Returns: -- string, if defined; false, if not local r if type( self ) == "table" and self.month then local slang = ( self.lang or World.slang ) r = World.monthsLong[ slang ] if r then local brief = World.monthsAbbr[ slang ] r = r[ self.month ] if brief then local ex = brief[ self.month ] local s = brief.suffix if ex then r = ex[ 2 ] else local n = brief.n or 3 r = mw.ustring.sub( r, 1, n ) end if s then r = r .. s end end end else r = false end return r
end -- Prototypes.first()
Prototypes.fix = function ( self )
-- Adapt this object to local time if no explicit zone given -- Parameter: -- self -- table, with numbers etc. if type( self ) == "table" and not self.zone then local seconds = Prototypes.format( self, "Z" ) Prototypes.future( self, - tonumber( seconds ) ) end
end -- Prototypes.fix()
Prototypes.flow = function ( self, another, assert )
-- Compare this object with another timestamp -- Parameter: -- self -- table, with numbers etc. -- another -- DateTime or string or nil (now) -- assert -- nil, or string with operator -- "lt", "le", "eq", "ne", "ge", "gt", -- "<", "<=", "==", "~=", "<>", ">=", "=>", ">" -- Returns: -- if assert: true or false -- else: -1, 0, 1 -- nil if invalid local base, other, r if type( self ) == "table" then base = self other = another elseif type( another ) == "table" then base = another other = self end if base then if type( other ) ~= "table" then other = Meta.fiat( other ) end if type( other ) == "table" then r = Private.flow( base, other ) if r and type( assert ) == "string" then local trsl = { lt = "<", ["<"] = "<", le = "<=", ["<="] = "<=", eq = "=", ["=="] = "=", ne = "<>", ["<>"] = "<>", ["~="] = "<>", ge = ">=", [">="] = ">=", ["=>"] = ">=", gt = ">", [">"] = ">" } local same = trsl[ assert:lower() ] if same then local s = "=" if r < 0 then s = "<" elseif r > 0 then s = ">" end r = ( same:find( s, 1, true ) ~= nil ) else r = nil end end end end return r
end -- Prototypes.flow()
Prototypes.format = function ( self, ask, adapt )
-- Format object as string -- Parameter: -- self -- table, with numbers etc. -- ask -- string, format spec, or nil -- adapt -- table, with options, or nil -- .lang -- string, with particular language code -- .london -- true: UTC output; default: local -- .lonely -- true: permit lonely hour -- Returns: -- string, or false, if invalid local r = false if type( self ) == "table" then local opts = { lang = self.lang } local babel, slang if type( adapt ) == "table" then if type( adapt.lang ) == "string" then local i = adapt.lang:find( "-", 3, true ) if i then slang = adapt.lang:lower() opts.lang = slang:sub( 1, i - 1 ) else opts.lang = adapt.lang:lower() end end opts.london = adapt.london opts.lonely = adapt.lonely end babel = mw.language.new( opts.lang ) if babel then local shift, show, stamp, suffix, limit4, locally if self.month then stamp = World.monthsLong.en[ self.month ] if self.year then stamp = string.format( "%s %04d", stamp, self.year ) end if self.dom then stamp = string.format( "%d %s", self.dom, stamp ) end if ask and ask:find( "Mon4" ) then local mon4 = World.months4[ opts.lang ] if mon4 then if mon4[ self.month ] then limit4 = true end end end elseif self.year then stamp = string.format( "%04d", self.year ) end if self.hour then stamp = string.format( "%s %02d:", stamp, self.hour ) if self.min then stamp = string.format( "%s%02d", stamp, self.min ) if self.sec then stamp = string.format( "%s:%02d", stamp, self.sec ) if self.msec then stamp = string.format( "%s.%03d", stamp, self.msec ) if self.mysec then stamp = string.format( "%s%03d", stamp, self.mysec ) end end end else stamp = stamp .. "00" end if self.zone then stamp = stamp .. World.zones.formatter( self, "+-" ) end end show, suffix = World.templates.formatter( self, ask, opts ) if limit4 then show = show:gsub( "M", "F" ) end if type( opts.london ) == "boolean" then locally = not opts.london else locally = true end r = babel:formatDate( show, stamp, locally ) r = r:gsub( " $", "" ) if self.year and self.year < 1000 then r = r:gsub( string.format( "%04d", self.year ), tostring( self.year ) ) end if self.month then local bucket, m, suite, x if show:find( "F" ) then suite = "monthsLong" elseif show:find( "M" ) then suite = "monthsAbbr" end bucket = World[ suite ] if bucket then m = bucket[ opts.lang ] if slang then x = bucket[ slang ] end if m then local base = m[ self.month ] local ex if x then ex = x[ self.month ] end if suite == "monthsAbbr" then local stop if ex then stop = x.suffix base = ex else stop = m.suffix end if base and stop then local shift, std std = string.format( "%s%%%s", base[ 1 ], stop ) shift = string.format( "%s%s", base[ 2 ], stop ) r = mw.ustring.gsub( r, std, shift ) end elseif suite == "monthsLong" then if base and ex then r = mw.ustring.gsub( r, base, ex ) end end end end end if suffix then r = r .. suffix end end end return r
end -- Prototypes.format()
Prototypes.full = function ( self )
-- Retrieve month name in current language -- Parameter: -- self -- table, to be evaluated -- Returns: -- string, if defined; false, if not local r if type( self ) == "table" and self.month then local slang = ( self.lang or World.slang ) r = World.monthsLong[ slang ] if r then r = r[ self.month ] end else r = false end return r
end -- Prototypes.full()
Prototypes.future = function ( self, add, allocate )
-- Relative move by interval -- Parameter: -- self -- table, to be used as base -- add -- string or number, to be added -- allocate -- true, if a clone shall be returned -- Returns: -- table, with shift local r, raw, rel, shift if type( self ) == "table" then r = self shift = add elseif type( add ) == "table" then r = add shift = self end if r then if r[ Meta.signature ] then raw = r[ Meta.signature ] else raw = r end if type( shift ) == "table" then rel = shift else rel = Private.future( shift ) end end if raw and rel then if allocate then r = Prototypes.clone( r ) raw = r[ Meta.signature ] end for k, v in pairs( rel ) do raw[ k ] = ( raw[ k ] or 0 ) + v end -- for k, v Calc.fair( raw ) r[ Meta.signature ] = raw end return r
end -- Prototypes.future()
Prototypes.tostring = function ( self )
-- Stringify yourself -- Parameter: -- self -- table, to be stringified -- Returns: -- string local dels = { false, "", "-", "-", "", ":", ":", ".", "", "" } local wids = { false, 4, 2, 2, 2, 2, 2, 2, 3, 3 } local s = "" local n, r, spec local f = function ( a ) n = self[ Meta.order[ a ] ] s = s .. dels[ a ] if n then spec = string.format( "%%s%%0%dd", wids[ a ] ) s = string.format( spec, s, n ) end end -- f() for i = 2, 5 do f( i ) end -- for i r = s s = "" for i = 6, 10 do f( i ) end -- for i if s == "::." then r = r:gsub( "%-+$", "" ) else if r == "--" then r = s else r = string.format( "%sT%s", r, s ) end end return r
end -- Prototypes.tostring()
Prototypes.valueOf = function ( self )
-- Returns yourselves primitive value (primitive table) -- Parameter: -- self -- table, to be dumped -- Returns: -- table, or false local r if type( self ) == "table" then r = self[ Meta.signature ] end return r or false
end -- Prototypes.valueOf()
Templates.flow = function ( frame, action )
-- Comparison invokation -- Parameter: -- frame -- object -- Returns: -- string, either "" or "1" local r local s1 = frame.args[ 1 ] local s2 = frame.args[ 2 ] if s1 then s1 = mw.text.trim( s1 ) if s1 == "" then s1 = false end end if s2 then s2 = mw.text.trim( s2 ) if s2 == "" then s2 = false end end if s1 or s2 then local l Frame = frame l, r = pcall( Prototypes.flow, Meta.fiat( s1 ), s2, action ) if r == true then r = "1" end end return r or ""
end -- Templates.flow()
World.templates.formatter = function ( assigned, ask, adapt )
-- Retrieve format specification string -- Parameter: -- assigned -- table, with numbers etc. -- ask -- string, format spec, or nil -- adapt -- table, with options -- .lang -- string, with particular language code -- .lonely -- true: permit lonely hour -- Returns: -- 1 -- string -- 2 -- string or nil; append suffix (zone) local r1, r2 if not ask or ask == "" then r1 = "c" else local template = World.templates[ ask ] r1 = ask if not template then local slang = ( adapt.lang or assigned.lang or World.slang ) local tmp = World.templates[ slang ] if tmp then template = tmp[ ask ] end end if type( template ) == "table" then local low = ( ask == "ISO" or ask == "ISO-T" ) r1 = template.spec if assigned.year then if not assigned.dom then r1 = r1:gsub( "[ .%-]?[dDjlNwz][ .,%-]*", "" ) :gsub( "^ ", "" ) if not assigned.month then r1 = r1:gsub( "[ .%-]?[FmMnt][ .%-]*", "" ) end end else r1 = r1:gsub( " ?[yY] ?", "" ) if not assigned.dom then r1 = r1:gsub( "[ .]?[dDjlNwz][ .,%-]*", "" ) :gsub( "^ ", "" ) end end if template.lift and (assigned.dom or not (assigned.month or assigned.year or assigned.bc) ) then local stamp = false if assigned.hour then if assigned.min then stamp = "H:i" if assigned.sec then stamp = "H:i:s" if assigned.msec then stamp = string.format( "%s.%03d", stamp, assigned.msec ) if assigned.mysec then stamp = string.format( "%s.%03d", stamp, assigned.mysec ) end end end elseif adapt.lonely then stamp = "H" end end if low or ask:find( "hh:mm:ss" ) then if stamp then r1 = string.format( "%s %s", r1, stamp ) end end if stamp then if low or template.long then local scheme if template.long then scheme = mw.language.getContentLanguage() scheme = scheme.code end r2 = World.zones.formatter( assigned, scheme ) end end end if type ( assigned.bc ) == "boolean" then local eras = World.era[ adapt.lang ] or World.era.en local i if not r2 then r2 = "" end if assigned.bc then i = 1 else i = 2 end r2 = string.format( "%s %s", r2, eras[ i ] ) end end end return r1, r2
end -- World.templates.formatter()
World.zones.formatter = function ( assigned, align )
-- Retrieve time zone specification string -- Parameter: -- assigned -- table, with numbers etc. -- .zone should be available -- align -- string, format spec, or nil -- nil, false, "+-" -- +/- 0000 -- "Z" -- single letter -- "UTC" -- "UTC", if appropriate -- "de" -- try localized -- Returns: -- string local r = "" local move = 0 if assigned.zone then local s = type( assigned.zone ) if s == "string" then s = assigned.zone:upper() if #s == 1 then -- "YXWVUTSRQPONZABCDEFGHIKLM" move = World.zones[ "!" ]:find( s ) if move then move = ( move - 13 ) * 100 assigned.zone = move else assigned.zone = false end else local code = World.zones[ s ] if not code then local slang = ( assigned.lang or World.slang ) local tmp = World.zones[ slang ] if tmp then code = tmp[ s ] end if not code and slang ~= "en" and World.zones.en then code = World.zones.en[ s ] end end if code then move = code assigned.zone = move end end elseif s == "number" then move = assigned.zone end end if move then local spec = "+-" if align then if align == "Z" then if move % 100 == 0 then r = World.zones[ "!" ]:sub( move / 100 + 13, 1 ) spec = false end elseif align ~= "+-" then if move == 0 then r = " UTC" spec = false else local part = World.zones[ align ] if part then for k, v in pairs( part ) do if v == move then r = string.format( " (%s)", k ) spec = false break end end -- for k, v end end end end if spec == "+-" then if move < 0 then spec = "%4.4d" else spec = "+%4.4d" end r = string.format( spec, move ) r = string.format( "%s:%s", r:sub( 1, 3), r:sub( 4 ) ) end end return r
end -- World.zones.formatter()
-- Export local p = { }
function p.test( args, alien )
local slang = args.lang or alien local obj = Meta.fiat( args[ 1 ], false, args.shift ) local r if type( obj ) == "table" then local spec = args[ 2 ] local opt if spec then spec = mw.text.trim( spec ) end if slang then opt = { lang = mw.text.trim( slang ) } end r = obj:format( spec, opt ) else r = ( args.noerror or "0" ) if r == "0" then r = fault( "Format invalid" ) else r = "" end end return r
end -- p.test
function p.failsafe( frame )
local s = type( frame ) local r, since if s == "table" then since = frame.args[ 1 ] elseif s == "string" then since = mw.text.trim( since ) if since == "" then since = false end end return Prototypes.failsafe( false, since ) or ""
end -- p.failsafe
function p.format( frame )
-- 1 -- stamp -- 2 -- spec -- lang -- shift -- noerror local l, r local v = { frame.args[ 1 ], frame.args[ 2 ], shift = frame.args.shift, noerror = frame.args.noerror } if not v[ 1 ] or v[ 1 ] == "now" then v[ 1 ] = frame:callParserFunction( "#timel", "c", v.shift ) v.shift = false end Frame = frame l, r = pcall( p.test, v, frame.args[ 3 ] or frame.args.lang ) if not l then r = fault( r ) end return r
end -- p.format
function p.lt( frame )
return Templates.flow( frame, "lt" )
end -- p.lt function p.le( frame )
return Templates.flow( frame, "le" )
end -- p.le function p.eq( frame )
return Templates.flow( frame, "eq" )
end -- p.eq function p.ne( frame )
return Templates.flow( frame, "ne" )
end -- p.ne function p.ge( frame )
return Templates.flow( frame, "ge" )
end -- p.ge function p.gt( frame )
return Templates.flow( frame, "gt" )
end -- p.gt
p.DateTime = function ()
return DateTime
end -- p.DateTime
return p