«Մոդուլ:Complex date»–ի խմբագրումների տարբերություն

Ավելացվել է 9773 բայտ ,  3 ամիս առաջ
Առանց խմբագրման ամփոփման
(Նոր էջ «--[[ This module is intended for creation of complex date phrases in variety of languages. Once deployed, please do not modify this code without applying the changes first...»:)
 
 
--[[
__ __ _ _ ____ _ _
| \/ | ___ __| |_ _| | ___ _ / ___|___ _ __ ___ _ __ | | _____ __ __| | __ _| |_ ___
| |\/| |/ _ \ / _` | | | | |/ _ (_) | / _ \| '_ ` _ \| '_ \| |/ _ \ \/ / / _` |/ _` | __/ _ \
| | | | (_) | (_| | |_| | | __/_| |__| (_) | | | | | | |_) | | __/> < | (_| | (_| | || __/
|_| |_|\___/ \__,_|\__,_|_|\___(_)\____\___/|_| |_| |_| .__/|_|\___/_/\_\ \__,_|\__,_|\__\___|
|_|
 
This module is intended for creation of complex date phrases in variety of languages.
 
Once deployed, please do not modify this code without applying the changes first at Module:Complex date/sandbox and testing
at Module:Complex date/sandbox/testcases.
 
Authors and maintainers:
* User:Sn1per - first draft of the original version
* User:Jarekt - corrections and expansion of the original version
]]
 
-- List of external modules and functions
local p = {Error = nil}
local i18n = require('Module:i18n/complex date') -- used for translations of date related phrases
local langSwitchISOdate = require('Module:FallbackISOdate')._langSwitch_ISOdate -- used for parsing dates in YYYY-MM-DD and related formats
local Calendar -- loaded lazily
local ISOdate = require('Module:ISOdate')._ISOdate
local Date = require('Module:Date')._Date
local formatnum = require('Module:Formatnum ')._main
local linguistic = require('Module:Linguistic')
 
-- ==================================================
-- ==================================================
 
local function formatnum1langSwitch(numStrlist, lang)
local langList = mw.language.getFallbacksFor(lang)
-- mostly require('Module:Formatnum ')._main function used to translate a number to use different numeral characters,
table.insert(langList,1,lang)
table.insert(langList,math.max(#langList,2),'default')
for i,language in ipairs(langList) do
if list[language] then
return list[language]
end
end
end
 
-- ==================================================
local function formatnum1(numStr, lang)
-- mostly require('Module:Formatnum').formatNum function used to translate a number to use different numeral characters,
-- except that it it does not call that function unless the language is on the list "LList"
local LList = {bn=1,bpy=1,kn=1,hi=1,mr=1,new=1,pa=1,gu=1,fa=1,glk=1,mzn=1,ur=1,ar=1,ckb=1,ks=1,lo=1,['or']=1,bo=1,['ml-old']=1,mn=1,te=1,th=1}
if LList[lang] then -- call only when the language is on the list
numStr = formatnumrequire('Module:Formatnum').formatNum(numStr, lang, 1)
end
return numStr
end
 
-- ==================================================
function getISODate(datestr, datetype, lang, num, case)
local function getISODate(datestr, datetype, lang, num, case)
-- translate dates in the format YYYY, YYYY-MM, and YYYY-MM-DD
if not case and i18n.Translations[datetype] then
end
 
-- =======================================================================
function translatePhrase(date1, date2, operation, lang, state)
local function translatePhrase(date1, date2, operation, lang, state)
-- use tables in Module:i18n/complex date to translate a phrase
if not i18n.Translations[operation] then
end
if type(dateStr)=='function' then
local successdateFunc = dateStr
local nDates = i18n.Translations[operation]['nDates']
if nDates==2 then -- 2 date phrase
success, dateStr = pcalldateFunc(dateStr, date1, date2, state)
else -- 1 date phrase
success, dateStr = pcalldateFunc(dateStr, date1, state)
end
end
-- replace parts of the string '$date1' and '$date2' with date1 and date2 strings
dateStr =if mw.ustring.gsubtype(dateStr, )=='$date1string', date1)then
-- replace parts of the string '$date1' and '$date2' with date1 and date2 strings
dateStr = mw.ustring.gsub(dateStr, '$date2', date2)
dateStr = mw.ustring.gsub(dateStr, '$date1', date1)
dateStr = mw.ustring.gsub(dateStr, '$date2', date2)
else
-- Special case of more complex phrases that can be build out of simple phrases
-- If complex case is not translated to "lang" than build it out of simpler ones
local x = dateStr
dateStr = p._complex_date(x.conj, x.adj1, date1, x.units1, x.era1, x.adj2, date2, x.units2, x.era2, lang, 2)
end
return dateStr
end
 
-- =======================================================================
function oneDatePhrase(dateStr, adj, era, units, lang, num, case, state)
local function oneDatePhrase(dateStr, adj, era, units, lang, num, case, state)
-- translate a single date phrase
if num==2 then
-- dateStr can have many forms: ISO date, year or a number for
state.adj, state.era, state.units, state.precision = state.adj2, state.era2, state.units2, state.precision2
end
-- dateStr can have many forms: ISO date, year or a number for
-- decade, century or millennium
if units == '' then -- unit is "year", "month", "day"
end
-- add adjective ("early", "mid", etc.) or preposition ("before", "after",
-- "circa", etc.) to the date
if adj ~= '' then
end
 
-- =======================================================================
function twoDatePhrase(date1, date2, state, lang)
local function twoDatePhrase(date1, date2, state, lang)
-- translate a double date phrase
local dateStr, case
end
 
-- =======================================================================
function otherPhrases(date1, date2, operation, era, lang, state)
local function otherPhrases(date1, date2, operation, era, lang, state)
-- translate specialized phrases
local dateStr = ''
era = ''
elseif operation == 'julian' then
if not date2 and date1 then -- Convert from Julian to Gregorian calendar date
if Calendar == nil then
Calendar = require("Module:Calendar") -- lazy loding (only if needed)
end
local JDN = Calendar._date2jdn(date1, 0)
if JDN then
date2 = date1 -- first date is assumed to be Julian
date1 = Calendar._jdn2date(JDN, 1)
end
end
date1 = getISODate(date1, operation, lang, 1, nil)
date2 = getISODate(date2, operation, lang, 2, nil)
dateStr = translatePhrase(date1, date2, operation, lang, state)
dateStr = mw.ustring.gsub(mw.ustring.gsub(dateStr, '%( ', '('), ' %)', ')') -- in case date2 is empty
elseif operation == 'turn of the year' or operation == 'turn of the decade' or operation == 'turn of the century' then
if elseif operation == 'turn of the decadeyear' thenor dtoperation ==10 else'turn of the decade' or operation dt=1= end'turn of the century' then
local dt = 1
if operation == 'turn of the decade' then dt=10 end
if not date2 or date2=='' then date2=tostring(tonumber(date1)-dt) end
if era~='bp' and era~='bc' then date1, date2 = date2, date1 end
dateStr = translatePhrase(date1, date2, operation, lang, state)
elseif operation == 'year unknown' then
dateStr = translatePhrase('', '', operation, lang, state) .. '<div style="display: none;">Unknown date</div>'
elseif operation == 'unknown' then
dateStr = tostring(mw.message.new( "exif-unknowndate" ):inLanguage( lang )) .. '<div style="display: none;">Unknown date</div>'
end
end
 
-- =======================================================================
function checkAliases(str1, str2, sType)
local function checkAliases(str1, str2, sType)
-- some inputs have many aliases - reconcile them and ensure string is playing a proper role
local out = ''
if str1 and str1~='' then
local a = i18n.Synonyms[str1] -- look up synonyms of "str1"
if a then
out = a[1]
else
p.Error = string.format('<span style="background-color:red;">Error in [[Module:Complex date]]: %s is not recognized.</span>', str1)
end
elseif str2 and str2~='' then -- if "str1" of type "sType" is empty than maybe ...
local a = i18n.Synonyms[str2] -- ..."str2" is of the same type and is not empty
if a and a[2]==sType then
out = a[1]
str2 = ''
end
end
return out, str2
end
return out, str2
end
 
-- =======================================================================
function datePrecision(dateStr, units)
local function datePrecision(dateStr, units)
-- "in this module "Units" is a string like millennium, century, or decade
-- "precision" is wikibase compatible date precision number: 6=millennium, 7=century, 8=decade, 9=year, 10=month, 11=day
-- based on string or numeric input calculate "Units" and "precision"
local precision
 
if type(units)=='number' then
precision = units
if precision>11 then precision=11 end -- clip the range of precision values
if precision==6 then units='millenniommillennium'
elseif precision==7 then units='century'
elseif precision==8 then units='decade'
end
elseif type(units)=='string' then
units = string.lower(units);
if units=='millenniommillennium' then precision=6
elseif units=='century' then precision=7
elseif units=='decade' then precision=8
units=''
end
if precision==6 and dateStr.match( dateStr, '%d000' )~=nil then
return units, precision
dateStr = tostring(math.floor(tonumber(dateStr)/1000) +1)
elseif precision==7 and mw.ustring.match( dateStr, '%d%d00' )~=nil then
dateStr = tostring(math.floor(tonumber(dateStr)/100) +1)
end
 
return dateStr, units, precision
end
 
-- =======================================================================
local function isodate2timestamp(dateStr, precision, era)
-- === External functions ===========================
-- convert date string to timestamps used by Quick Statements
-- ==================================================
local tStamp = nil
if era == 'ah' or precision<6 then
return nil
elseif era ~= '' then
local eraLUT = {ad='+', bc='-', bp='-' }
era = eraLUT[era]
else
era='+'
end
 
-- convert isodate to timestamp used by quick statements
function p.Era(frame)
if precision>=9 then
-- process inputs
if string.match(dateStr,"^%d%d%d%d$") then -- if YYYY format
local dateStr
tStamp = era .. dateStr .. '-00-00T00:00:00Z/9'
local args = frame.args
elseif string.match(dateStr,"^%d%d%d%d%-%d%d$") then -- if YYYY-MM format
local dateStr = args['date'] or ''
tStamp = era .. dateStr .. '-00T00:00:00Z/10'
local eraType = string.lower(args['era'] or '')
elseif string.match(dateStr,"^%d%d%d%d%-%d%d%-%d%d$") then -- if YYYY-MM-DD format
local lang = args['lang'] or ''
tStamp = era .. dateStr .. 'T00:00:00Z/11'
if lang == '' then
end
lang = mw.message.new( "lang" ):plain()
elseif precision==8 then -- decade
tStamp = era .. dateStr .. '-00-00T00:00:00Z/8'
elseif precision==7 then -- century
local d = tostring(tonumber(dateStr)-1)
tStamp = era .. d .. '50-00-00T00:00:00Z/7'
elseif precision==6 then
local d = tostring(tonumber(dateStr)-1)
tStamp = era .. d .. '500-00-00T00:00:00Z/6'
end
return tStamp
end
 
-- =======================================================================
local function oneDateQScode(dateStr, adj, era, precision)
-- create QuickStatements string for "one date" dates
local outputStr = ''
 
dateStrlocal d = ISOdateisodate2timestamp(dateStr, lang, '', ''precision, 1era)
if eraTypenot thend then
return ''
eraType = checkAliases(eraType ,'','e')
dateStr = translatePhrase(dateStr, '', eraType, lang, {})
end
local rLUT = { early='Q40719727' , mid='Q40719748', late='Q40719766',
return dateStr
['1quarter']='Q40690303' , ['2quarter']='Q40719649' , ['3quarter']='Q40719662', ['4quarter']='Q40719674',
spring='Q40720559' , summer='Q40720564' , autumn='Q40720568' , winter='Q40720553',
firsthalf='Q40719687', secondhalf='Q40719707' }
local qLUT = {['from']='P580', ['until']='P582', ['after']='P1319', ['before']='P1326', ['by']='P1326'}
 
local refine = rLUT[adj]
local qualitier = qLUT[adj]
 
if adj=='' then
outputStr = d
elseif adj=='circa' then
outputStr = d..",P1480,Q5727902"
elseif refine then
outputStr = d..",P4241,"..refine
elseif precision>7 and qualitier then
local century = string.gsub(d, 'Z%/%d+', 'Z/7')
outputStr = century ..",".. qualitier ..","..d
end
return outputStr
end
 
-- =======================================================================
function p.complex_date(frame)
local function twoDateQScode(date1, date2, state)
-- process inputs
-- create QuickStatements string for "two date" dates
local dateStr, Error
if state.adj1~='' or state.adj2~='' or state.era1~=state.era2 then
local args = frame.args
return '' -- QuickStatements string are not generated for two date phrases with adjectives
local date1 = args['date1'] or args['2'] or args['date'] or ''
local date2 = args['date2'] or args['3'] or ''
local conj = args['conj'] or args['1'] or ''
local adj1 = args['adj1'] or args['adj'] or ''
local adj2 = args['adj2'] or ''
local units1 = args['precision1'] or args['precision'] or ''
local units2 = args['precision2'] or args['precision'] or ''
local era1 = args['era1'] or args['era'] or ''
local era2 = args['era2'] or args['era'] or ''
local lang = args['lang'] or ''
if lang == '' then
lang = mw.message.new( "lang" ):plain()
end
local outputStr = ''
dateStr = p._complex_date(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang)
local d1 = isodate2timestamp(date1, state.precision1, state.era1)
if p.Error~=nil then
local d2 = isodate2timestamp(date2, state.precision2, state.era2)
dateStr = p.Error .. '[[Category:Pages using Complex date template with incorrect parameter]]'
if (not d1) or (not d2) then
return ''
end
-- find date with lower precision in common to both dates
return dateStr
local cd
local year1 = tonumber(string.sub(d1,2,5))
local year2 = tonumber(string.sub(d2,2,5))
local k = 0
for i = 1,10,1 do
if string.sub(d1,1,i)==string.sub(d2,1,i) then
k = i -- find last matching letter
end
end
if k>=9 then -- same month, since "+YYYY-MM-" is in common
cd = isodate2timestamp(string.sub(d1,2,8), 10, state.era1)
elseif k>=6 and k<9 then -- same year, since "+YYYY-" is in common
cd = isodate2timestamp(tostring(year1), 9, state.era1)
elseif k==4 then -- same decade(k=4, precision=8), since "+YYY" is in common
cd = isodate2timestamp(tostring(year1), 8, state.era1)
elseif k==3 then -- same century(k=3, precision=7) since "+YY" is in common
local d = tostring(math.floor(year1/100) +1) -- convert 1999 -> 20
cd = isodate2timestamp( d, 7, state.era1)
elseif k==2 then -- same millennium (k=2, precision=6), since "+Y" is in common
local d = tostring(math.floor(year1/1000) +1) -- convert 1999 -> 2
cd = isodate2timestamp( d, 6, state.era1)
end
if not cd then
return ''
end
--if not cd then
-- return ' <br/>error: ' .. d1.." / " .. d2.." / ".. (cd or '') .." / ".. string.sub(d1,2,5).." / " .. string.sub(d2,2,5).." / " .. tostring(k)
--end
 
--
if (state.conj=='from-until') or (state.conj=='and' and year1==year2-1) then
outputStr = cd ..",P580,".. d1 ..",P582,".. d2
elseif (state.conj=='between') or (state.conj=='or' and year1==year2-1) then
outputStr = cd ..",P1319,".. d1 ..",P1326,".. d2
elseif state.conj=='circa2' then
outputStr = cd ..",P1319,".. d1 ..",P1326,".. d2 ..",P1480,Q5727902"
end
 
return outputStr
end
function p._complex_date(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang)
local Output=''
 
-- =======================================================================
-- process inputs
local function processInputParams(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang, passNr)
local state = {}
 
state.conj = string.lower(conj or '')
-- process inputs and save date in state array
state.adj1 = string.lower(adj1 or '')
local state.adj2 = string.lower(adj2 or= ''){}
state.era1conj = string.lower(era1conj or '')
state.era2adj1 = string.lower(era2adj1 or '')
state.adj2 = string.lower(adj2 or '')
state.era1 = string.lower(era1 or '')
-- calculate date precision value
state.units1,era2 state.precision1 = datePrecisionstring.lower(date1,era2 units1 or '')
state.units2, state.precision2units1 = datePrecisionstring.lower(date2, units2units1 or '')
state.units2 = string.lower(units2 or '')
 
-- if date 1 is missing but date 2 is provided than swap them
if date1 == '' and date2 ~= '' then
date1 = date2
date2 = ''
state = {adj1 = state.adj2, era1 = state.era2, units1 = state.units2, precision1=state.precision2,
adj2 = '', era2 = '', units2 = '', precision2='', conj=state.conj, num=1}
end
if date2 ~= '' then state.nDates = 2
elseif date1 ~= '' then state.nDates = 1
else state.nDates = 0
end
 
-- reconcile alternative names for text inputs
local conj = checkAliases(state.conj ,'' ,'j')
return nil
end
 
-- calculate date precision value
-- handle special cases
ifdate1, state.adj1=='circa' andunits1, state.nDatesprecision1 == 2datePrecision(date1, thenstate.units1)
date2, state.units2, state.precision2 = datePrecision(date2, state.units2)
state.conj = 'circa2'
 
state.adj1 = ''
-- Handle special cases
state.adj2 = ''
-- Some complex phrases can be created out of simpler ones. Therefore on pass # 1 we try to create
end
-- the phrase using complex phrase and if that is not found than on the second pass we try to build
if state.nDates == 2 and state.adj1=='late' and state.adj2=='early' and state.conj=='and' and state.units1==state.units2 and state.era1==state.era2 then
-- the phrase out of the simpler ones
if state.units1=='century' then
if passNr==1 then
state.conj='turn of the century'
elseifif state.units1adj1=='decadecirca' and state.nDates == 2 then
state.conj = 'turn of the decadecirca2'
elseif state.units1=adj1 = '' then
state.conjadj2 = 'turn of the year'
end
if state.nDates == 2 and state.adj1=='late' and state.adj2=='early' and state.conj=='and'
and state.units1==state.units2 and state.era1==state.era2 then
if state.units1=='century' then
state.conj='turn of the century'
elseif state.units1=='decade' then
state.conj='turn of the decade'
elseif state.units1=='' then
state.conj='turn of the year'
end
state.adj1 = ''
state.adj2 = ''
state.units1 = ''
state.units2 = ''
end
state.adj1 = ''
state.adj2 = ''
state.units1 = ''
state.units2 = ''
end
 
state.adj, state.era, state.units, state.precision = state.adj1, state.era1, state.units1, state.precision1
return date1, date2, state
end
 
-- ==================================================
-- === External functions ===========================
-- ==================================================
 
function p.Era(frame)
-- process inputs
local dateStr
local args = frame.args
if not (args.lang and mw.language.isSupportedLanguage(args.lang)) then
args.lang = frame:callParserFunction( "int", "lang" ) -- get user's chosen language
end
local lang = args['lang']
local dateStr = args['date'] or ''
local eraType = string.lower(args['era'] or '')
 
dateStr = ISOdate(dateStr, lang, '', '', 1)
if eraType then
eraType = checkAliases(eraType ,'','e')
dateStr = translatePhrase(dateStr, '', eraType, lang, {})
end
return dateStr
end
 
-- =======================================================================
function p._complex_date(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang, passNr)
local Output=''
local state
 
-- process inputs and save date in state array
date1, date2, state = processInputParams(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang, passNr)
if p.Error~=nil then
return nil
end
 
local errorStr = string.format(
'\n*conj=%s, adj1=%s, era1=%s, unit1=%s, prec1=%i, adj2=%s, era2=%s, unit2=%s, prec2=%i, special=%s',
state.conj, state.adj1, state.era1, state.units1, state.precision1,
state.adj2, state.era2, state.units2, state.precision2, state.special)
 
-- call specialized functions
local QScode = ''
if state.special~='' then
Output = otherPhrases(date1, date2, state.special, state.era1, lang, state)
elseif state.conj~='' then
QScode = twoDateQScode(date1, date2, state)
Output = twoDatePhrase(date1, date2, state, lang)
elseif state.adj1~='' or state.era1~='' or state.units1~='' then
Output = oneDatePhrase(date1, state.adj1, state.era1, state.units1, lang, 1, nil, state)
QScode = oneDateQScode(date1, state.adj1, state.era1, state.precision1)
elseif date1~='' then
Output = ISOdate(date1, lang, '', 'dtstart', '100-999')
if mw.ustring.find(Output, '{') then
Output = mw.getCurrentFrame():preprocess(Output)
end
if QScode and #QScode>0 then
QScode = ' <div style="display: none;">date QS:P,' .. QScode .. '</div>'
end
 
return Output .. QScode
end
 
-- =======================================================================
function p._complex_date_cer(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, certainty, lang)
-- same as p._complex_date but with extra parameter for certainty: probably, possibly, presumably, etc.
local dateStr = p._complex_date(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang, 1)
certainty = checkAliases(certainty, conj, 'r')
local LUT = {probably='Q56644435', presumably='Q18122778', possibly='Q30230067', circa='Q5727902' }
if certainty and LUT[certainty] then
local state = {}
date1, date2, state = processInputParams(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, lang, 1)
dateStr = translatePhrase(dateStr, '', certainty, lang, state)
dateStr = string.gsub(dateStr, '(%<div style="display: none;"%>date QS:P,[^%<]+)(%</div%>)', '%1,P1480,' .. LUT[certainty] .. '%2' )
end
return dateStr
end
 
-- =======================================================================
function p.complex_date(frame)
-- process inputs
local dateStr
local args = frame.args
if not (args.lang and mw.language.isSupportedLanguage(args.lang)) then
args.lang = frame:callParserFunction( "int", "lang" ) -- get user's chosen language
end
local date1 = args['date1'] or args['2'] or args['date'] or ''
local date2 = args['date2'] or args['3'] or ''
local conj = args['conj'] or args['1'] or ''
local adj1 = args['adj1'] or args['adj'] or ''
local adj2 = args['adj2'] or ''
local units1 = args['precision1'] or args['precision'] or ''
local units2 = args['precision2'] or args['precision'] or ''
local era1 = args['era1'] or args['era'] or ''
local era2 = args['era2'] or args['era'] or ''
local certainty = args['certainty']
local lang = args['lang']
 
dateStr = p._complex_date_cer(conj, adj1, date1, units1, era1, adj2, date2, units2, era2, certainty, lang)
if p.Error~=nil then
dateStr = p.Error .. '[[Category:Pages using Complex date template with incorrect parameter]]'
end
return dateStr
end