وحدة:Hijri/core
المظهر
![]() | صُنّفت هذه الوحدة على أنها في المرحلة النهائية. في هذه المرحلة تكون الوحدة وصلت لنقطة يمكن أن تستخدم في أي صفحة أو أي نطاق. كما أنها تؤدي الهدف الذي بنيت من أجله ولا توجد أي أخطاء بها. يمكن أن يشار إلى هذه الوحدة في صفحات المساعدة أو أي صفحات إرشادية على ويكيبيديا، كما يمكن أن توضع كأمثلة للجدد ليتعلموا منها. |
مفعلة | فرق | ملاعب | الوصف | |
---|---|---|---|---|
وحدة:Hijri | فرق | ملعب | [تعديل] | تحوي على وظائف القوالب ووظائف مساعدة لها، والتي يتم استدعاؤها من من الصفحات. |
وحدة:Hijri/Calendar | فرق | ملعب | [تعديل] | تحوي الوظائف الأساسية لإخراج تقويم شهري وتستدعى من الصفحات والقوالب. |
وحدة:Hijri/core | فرق | ملعب | [تعديل] | تحوي على وظائف لوا أساسية لمعالجة التقاويم تستدعى من وحدات لوا فقط. |
وحدة:Hijri/adjusted data | فرق | ملعب | [تعديل] | تقوم هذه الوحدة بإخراج بيانات تقويم أم القرى مع التعديلات عليها والغرض من جعلها وحدة مستقلة وتسهيل تحميلها من أمر mw.loadData |
وحدة:Hijri/Configuration | فرق | ملعب | [تعديل] | جداول الترجمة، ومعالجات الأخطاء والمعرفات. |
وحدة:Hijri/umalqura data | فرق | لا ملعب لها | وحدة بيانات تحوي على بيانات تقويم أم القرى | |
وحدة:Hijri/adjustment data | فرق | ملعب | [تعديل] | وحدة بيانات تحوي على التعديلات على تقويم أم القرى |
--[[--------------- luaHijri---------------------
by hubaishan
v0.5
locate at https://github.com/hubaishan/luaHijri
]]
--[[ ------------ C O N F I G U R A T I O N S ----------------------]]
--[[ As
local adjust_data = { [1443] =
[5] = {2021,12,6},
[7] = 1 }
this means ad just start of month 5 of 1443 to 2021-12-06, and add one day to month 7 of 1443
]]
--local adjust_data = {} --adjust data in separate module
-- Gregorian Calender epoch used only for wertern calendar default value are in Italy some countries may differ
local gregorian_epoch = { jd = 2299161, y = 1582 , m = 10, d = 15}
-- sunday index can be 0 or 1
local wday_sunday = 0
-- day of year (1-1) index
local yday_1_1 = 0
-- @var int 1 to use adjusted Um Al-Qura algorithm, 2 to use Um Al-Qura algorithm, 0 use Hijri Tabular Algorithm
local hijri_mode = mw.loadData('Module:Hijri/Configuration').hijri_mode
--[[ ------------ C O N S T A N T S ----------------]]
-- the Um Al-Qura Calendar start year
local umstartyear = 1318
-- the Um Al-Qura Calendar end year
local umendyear = 1500
-- the Um Al-Qura Calendar start Julian day
local umstartjd = 2415140
-- the Um Al-Qura Calendar end Julian day
local umendjd = 2479960
local UMDATA_COUNT = 2196
--[[ ------------ V A R S ----------------]]
local adjusted_umdata
local raw_umdata
--[[------------------- U T I L T Y U S E F U L F U N C T I O N S------------------------]]
local floor = math.floor
local function round(number)
return floor(number + 0.5)
end
local function in_array( needle, haystack )
if needle == nil then
return false;
end
for n,v in ipairs( haystack ) do
if v == needle then
return n;
end
end
return false;
end
--[[------------------- C A L E N D A R F U N C T I O N S------------------------]]
--[[--- Data ---]]
local function gregorian2jd(year, month, day)
-- from postgresql source
local jd, century
if year < 1 then
year = year + 1
end
if month > 2 then
month = month + 1
year = year + 4800
else
month = month + 13
year = year + 4799
end
century = floor(year / 100)
return (year * 365 - 32167 + floor(year / 4) - century + floor(century / 4) + floor(7834 * month / 256) + day)
end
-- load Umm al-Qura Calendar Data
-- Modified for MediaWiki
local function get_umdata(mode)
mode = mode or hijri_mode
if mode==2 then
if raw_umdata==nil or #raw_umdata==0 then
raw_umdata = mw.loadData('Module:Hijri/umalqura data')
end
return raw_umdata
elseif mode==1 then
if adjusted_umdata == nil or #adjusted_umdata==0 then
adjusted_umdata = mw.loadData('Module:Hijri/adjusted data')
end
return adjusted_umdata
end
end
--[[--- Hijri ---]]
local function jd2hijri(julianday, mode)
local mjd, ii, n, y, i
local j, j1
local hy, hm, hd, hz
mode = mode or hijri_mode
if (mode>0 and (julianday > umstartjd) and (julianday < umendjd)) then
local umdata = get_umdata(mode)
i = floor((julianday - 1948438) / 29.53056) - ((umstartyear - 1) * 12)
mjd = julianday - 2400000
if i<0 then i = 0 end
for c = i, UMDATA_COUNT do
if (umdata[c] > mjd) then
i = c
break
end
end
ii = floor((i - 1) / 12)
hy = umstartyear + ii
hm = i - 12 * ii
hd = mjd - umdata[i - 1] + 1
hz = mjd - umdata[12 * ii]
else
j = julianday + 7666
n = floor(j / 10631)
j = j - (n * 10631)
j1 = j
y = floor(j / 354.36667)
j = j - round(y * 354.36667)
if j == 0 then
y=y-1
j = j1 - round(y * 354.36667)
hz = j
hd = j - 325
hm = 12
else
hz = j - 1
j = j + 29
hm = floor((24 * j) / 709)
hd = j - floor(((709 * hm) / 24))
end
hy = (n * 30) + y + 1
hy = hy - 5520
if hy <= 0 then
hy = hy - 1
end
end
hz = hz + yday_1_1
return hy, hm, hd, hz
end
local function hijri2jd(hy, hm, hd, mode)
mode = mode or hijri_mode
local ii, i, n
local j
if (mode > 0 and hy >= umstartyear and hy <= umendyear) then
local umdata = get_umdata(mode)
ii = hy - umstartyear
i = hm + 12 * ii
j = hd + umdata[i - 1] - 1
j = j + 2400000
elseif (hy < -5499 or (hy == -5499 and hm < 8) or (hy == -5499 and hm == 8 and hd < 18)) then
j = 0
else
hy = hy < 0 and (hy + 5520) or (hy + 5519)
n = floor(hy / 30)
j = (n * 10631) + round((hy - (n * 30)) * 354.36667)
hm = hm - 1
j = j + (hm * 29) + floor((hm + 1) / 2) + hd
j = j- 7666
end
return j
end
local function hijri_days_in_month(year, month, mode)
mode = mode or hijri_mode
local t = 29
if mode>0 and year >= umstartyear and year <= umendyear then
local i = (year-umstartyear)*12 + month -1
local umdata = get_umdata(mode)
t = umdata[i + 1] - umdata[i]
else
if month == 12 then
if year < 0 then
year = year + 5521
end
if round((year % 30) * 0.36667) > round(((year - 1) % 30) * 0.36667) then
t = 30
end
else
t = 29 + (month % 2);
end
end
return t
end
local function hijri_isleap(year, mode)
mode = mode or hijri_mode
local l
if mode>0 and year >= umstartyear and year <= umendyear then
local umdata = get_umdata(mode)
local ii = year - umstartyear
l = ((umdata[12 * (ii + 1)] - umdata[12 * ii]) > 354) and true or false
else
if year < 0 then
year = year + 5521;
end
l = (round((year % 30) * 0.36667) > round(((year - 1) % 30) * 0.36667)) and true or false
end
return l
end
local function hijri_yday(year,month,day,mode)
local ii
mode = mode or hijri_mode
if (mode>0 and year >= umstartyear and year <= umendyear) then
local umdata = get_umdata(mode)
ii = year - umstartyear
return umdata[(12 * ii) + month -1] - umdata[12 * ii] + day - 1 + yday_1_1
else
return select(month, 0,30,59,89,118,148,177,207,236,266,295,325) + day - 1 + yday_1_1
end
end
local function hijri_check(year,month,day,mode,may_adjusted)
if month < 1 or month > 12 then
return false
end
if day < 1 or day > 30 then
return false
end
if not may_adjusted and day > hijri_days_in_month(year,month,mode) then
return false
end
return true
end
--[[--- Unix and wday---]]
local function jd2unix(jd)
-- 2440588 -- J.D. of 1.1.1970
if jd == nil then
return nil
end
return ((jd - 2440588) * 24 * 3600)
end
local function unix2jd(unix)
if unix == nil then
return nil
end
return floor(unix/(24 * 3600)) + 2440588
end
--returns wday number sunday=wday_sunday
local function jd2wday(jd)
jd = jd + 1
jd = jd % 7
if (jd<0) then
jd = jd + 7
end
return jd + wday_sunday
end
--[[--- Gregorian ---]]
local function jd2gregorian(jd)
-- inspired by postgresql function
local julian, quad, extra, y
local year,month,day
julian = jd + 32044
quad = floor(julian / 146097)
extra = (julian - quad * 146097) * 4 + 3
julian = julian + 60 + quad * 3 + floor(extra / 146097)
quad = floor(julian / 1461)
julian = julian - quad * 1461
y = floor(julian * 4 / 1461)
if (y ~= 0) then
julian = ((julian + 305) % 365) + 123
else
julian = ((julian + 306) % 366) + 123
end
y = y + quad * 4;
year = y - 4800;
quad = floor(julian * 2141 / 65536)
day = julian - floor(7834 * quad / 256)
month = (quad + 10) % 12 + 1
if (year<1) then
year = year-1
end
return year,month,day
end
local function gre_isleap(year)
if year<1 then year=year+1 end
return (year % 4) == 0 and ((year % 100) ~= 0 or (year % 400) == 0)
end
local function gre_yday(year,month,day)
if gre_isleap(year) then
return select(month,0,31,60,91,121,152,182,213,244,274,305,335) + day - 1 + yday_1_1
else
return select(month,0,31,59,90,120,151,181,212,243,273,304,334) + day - 1 + yday_1_1
end
end
local function gre_days_in_month(year, month)
if month == 2 and gre_isleap(year) then
return 29
else
return select(month,31,28,31,30,31,30,31,31,30,31,30,31)
end
end
local function gre_check(year,month,day)
if month < 1 or month > 12 then
return false
end
if day < 1 or day > gre_days_in_month(year,month) then
return false
end
return true
end
--[[--- Julian ---]]
local function jd2julian(jd)
local year, month, day
local temp, dayofYear
temp = jd * 4 + (32083 * 4 - 1)
year = floor(temp / 1461)
dayofYear = floor((temp % 1461) / 4) + 1
temp = dayofYear * 5 - 3
month = floor(temp / 153)
day = floor((temp % 153) / 5) + 1
if (month < 10) then
month = month + 3
else
year = year + 1
month = month - 9
end
year = year - 4800
if (year < 1) then
year = year -1
end
return year, month, day
end
local function julian2jd(year,month,day)
if year<0 then
year = year + 4801
else
year = year + 4800
end
if month > 2 then
month = month -3
else
month = month + 9
year = year - 1
end
return (floor((year * 1461) / 4) + floor((month * 153 + 2) / 5) + day - 32083)
end
local function julian_isleap(year)
if year < 1 then year = year + 1 end
return (year % 4) == 0
end
local function julian_yday(year,month,day)
if julian_isleap(year) then
return select(month,0,31,60,91,121,152,182,213,244,274,305,335) + day - 1 + yday_1_1
else
return select(month,0,31,59,90,120,151,181,212,243,273,304,334) + day - 1 + yday_1_1
end
end
local function julian_days_in_month(year, month)
if month == 2 and julian_isleap(year) then
return 29
else
return select(month,31,28,31,30,31,30,31,31,30,31,30,31)
end
end
local function julian_check(year,month,day)
if month < 1 or month > 12 then
return false
end
if day < 1 or day > julian_days_in_month(year,month) then
return false
end
return true
end
--[[--- Convertion ---]]
-- Return Hijri Date from Gregorian date
local function gregorian2hijri(gyear, gmonth, gday)
return jd2hijri(gregorian2jd(gyear, gmonth, gday))
end
local function hijri2gregorian(hyear, hmonth, hday)
return jd2gregorian(hijri2jd(hyear, hmonth, hday))
end
--[[------------------- D A T E C L A S S ------------------------]]
local datePrototype = {}
-- Set julianDay
function datePrototype:set_jd(arg_jd)
if self.p.type == 'hijri' then
self.p.year, self.p.month, self.p.day, self.p.yday = jd2hijri(arg_jd,self.p.mode)
self.p.jd = arg_jd
elseif self.p.type == 'gregorian' or (self.p.type == 'western' and arg_jd >= gregorian_epoch.jd ) then
self.p.year, self.p.month, self.p.day = jd2gregorian(arg_jd)
self.p.jd, self.p.yday = arg_jd, nil
elseif self.p.type == 'julian' or (self.p.type == 'western' and arg_jd < gregorian_epoch.jd ) then
self.p.year, self.p.month, self.p.day = jd2julian(arg_jd)
self.p.jd, self.p.yday = arg_jd, nil
end
self.p.wday, self.p.month_days, self.p.leap_year = nil, nil, nil
end
function datePrototype:get_jd()
if self.p.jd ~= nil then
return self.p.jd
elseif self.p.year and self.p.month and self.p.day then
self:set_date(self.p.year,self.p.month,self.p.day)
else
local t=os.date("*t")
if self.p.type=='gregorian' then
self.p.year, self.p.month, self.p.day, self.p.wday, self.p.yday = t.year, t.month, t.day, t.wday - 1 + wday_sunday, t.yday
self.p.jd = gregorian2jd(self.p.year, self.p.month, self.p.day)
else
self:from_gregorian(t.year,t.month,t.day)
self.p.wday = t.wday -1 + wday_sunday
end
end
return self.p.jd
end
function datePrototype:set_timestamp(arg_tm)
if self.p.timestamp == arg_tm then
return
end
self.p.timestamp = arg_tm
self:set_jd(unix2jd(arg_tm))
end
-- adjust type of western calendar
local function adj_type(type,year,month,day)
if type == 'western' then
if year>gregorian_epoch.y or (year==gregorian_epoch.y and month>gregorian_epoch.m) or (year==gregorian_epoch.y and month == gregorian_epoch.m and day>=gregorian_epoch.d) then
type='gregorian'
else
type = 'julian'
end
end
return type
end
-- Check the Date
local function check_date(ctype,cmode,year,month,day,may_adjusted)
local type = adj_type(ctype,year,month,day)
if month <1 or month >12 or day <1 or day >31 then
return false
elseif type == 'hijri' then
if day > 30 or (not may_adjusted and day> hijri_days_in_month(year,month,cmode)) then
return false
end
elseif day > select(month,31,29,31,30,31,30,31,31,30,31,30,31) then
return false
elseif month == 2 and day == 29 then
if (((year % 4) ~= 0) or (type == 'gregorian' and (year % 100) == 0 and (year % 400) ~= 0)) then
return false
end
end
return true
end
-- Set Date
-- may_adjusted argument used in Hijri only to accept any 30 day of any month
function datePrototype:set_date(year,month,day,may_adjusted)
if not check_date(self.p.type, self.p.mode, year, month, day, may_adjusted) then
error("Invalid Date")
end
local type=adj_type(self.p.type,year,month,day)
if type == 'hijri' then
self.p.jd = hijri2jd(year,month,day,self.p.mode)
elseif type == 'gregorian' then
self.p.jd = gregorian2jd(year,month,day)
elseif type == 'julian' then
self.p.jd = julian2jd(year,month,day)
end
self.p.year, self.p.month, self.p.day = year,month,day
self.p.wday, self.p.month_days, self.p.leap_year, self.p.yday = nil, nil, nil, nil
end
-- Convert date from hijri
function datePrototype:from_hijri(year,month,day,wday,mode)
mode = mode or self.p.mode
local jd = hijri2jd(year,month,day,mode)
if wday and wday <= 6 and wday >=0 then
local jd_weekday = jd2wday(jd)
local differ = wday - jd_weekday
if differ < - 4 then
jd = jd + (differ + 7)
elseif differ > -3 and differ < 3 then
jd = jd + differ
elseif differ > 4 then
jd = jd + (differ - 7)
else
error("Weekday is very far from Hijri date")
end
end
if self.p.type == 'hijri' and check_date(self.p.type, self.p.mode, year,month,day,true) then
self.p.year,self.p.month,self.p.day,self.p.jd=year,month,day,jd
self.p.wday, self.p.month_days, self.p.leap_year, self.p.yday = nil, nil, nil, nil
else
self:set_jd(jd)
end
end
-- Convert date from Gregorian
function datePrototype:from_gregorian(year,month,day)
self:set_jd(gregorian2jd(year,month,day))
end
-- Convert date from Julian
function datePrototype:from_julian(year,month,day)
self:set_jd(julian2jd(year,month,day))
end
-- Convert date from Western
function datePrototype:from_western(year,month,day)
if year>gregorian_epoch.y or (year==gregorian_epoch.y and month>gregorian_epoch.m) or (year==gregorian_epoch.y and month == gregorian_epoch.m and day>=gregorian_epoch.d) then
self:set_jd(gregorian2jd(year,month,day))
else
self:set_jd(julian2jd(year,month,day))
end
end
-- set type of calendar
function datePrototype:set_type(arg_type)
local new_type,new_mode
arg_type = string.lower(arg_type)
if in_array(arg_type, {'hijri', 'hijri_adjusted_umalqura', 'hijri_umalqura', 'hijri_tabular', 'gregorian', 'julian', 'western'}) then
if string.sub(arg_type,1,5) == 'hijri' then
new_type = 'hijri'
if arg_type == 'hijri_umalqura' then
new_mode = 2
elseif arg_type == 'hijri_tabular' then
new_mode = 0
else
new_mode = 1
end
else
new_type = arg_type
end
if new_type ~= self.p.type or new_mode ~= self.p.mode then
self.p.type = new_type
self.p.mode = new_mode
if self.p.jd then
self:set_jd(self.p.jd)
end
end
else
error('bad calendar type')
end
end
function datePrototype:get_value(key)
if not self.p[key] then
local jd = self:get_jd() -- to init calendar if not
if key=='wday' then
self.p.wday = jd2wday(jd)
elseif key == 'timestamp' then
self.p.timestamp = jd2unix(jd)
else
if self.p.type=='hijri' and key=='leap_year' then
self.p.leap_year = hijri_isleap(self.p.year,self.p.mode)
elseif self.p.type == 'gregorian' or (self.p.type == 'western' and self.p.year > gregorian_epoch.y ) then
self.p.leap_year = gre_isleap(self.p.year)
elseif self.p.type == 'julian' or (self.p.type == 'western' and self.p.year <= gregorian_epoch.y ) then
self.p.leap_year = julian_isleap(self.p.year)
end
if key == 'yday' then
if self.p.type ~= 'hijri' then
if self.p.leap_year then
self.p.yday = select(self.p.month,0,31,60,91,121,152,182,213,244,274,305,335) + self.p.day - 1 + yday_1_1
else
self.p.yday = select(self.p.month,0,31,59,90,120,151,181,212,243,273,304,334) + self.p.day - 1 + yday_1_1
end
elseif self.p.type == 'hijri' then
self.p.yday = hijri_yday(self.p.year,self.p.month,self.p.day,self.p.mode)
end
elseif key == 'month_days' then
if self.p.type=='hijri' then
self.p.month_days = hijri_days_in_month(self.p.year,self.p.month,self.p.mode)
else
if self.p.month == 2 and self.p.leap_year then
self.p.month_days = 29
else
self.p.month_days = select(self.p.month,31,28,31,30,31,30,31,31,30,31,30,31)
end
end
end
end
end
return self.p[key]
end
-- add interval to date
function datePrototype:add(y, m, d)
y,m,d = tonumber(y) or 0,tonumber(m) or 0,tonumber(d) or 0
local jd = self:get_jd()
if y==0 and m == 0 then
jd = jd + d
else
local year,month,day=self.p.year + y, self.p.month + m, self.p.day + d
if self.p.type == 'hijri' then
jd = hijri2jd(year,month,day,self.p.mode)
elseif self.p.type == 'gregorian' then
jd = gregorian2jd(year,month,day)
elseif self.p.type == 'julian' then
jd = julian2jd(year,month,day)
elseif self.p.type == 'western' then
if self.p.jd >= gregorian_epoch.jd then
jd = gregorian2jd(year,month,day)
if jd< gregorian_epoch.jd then
jd = julian2jd(year,month,day)
end
else
jd = julian2jd(year,month,day)
if jd>= gregorian_epoch.jd then
jd = gregorian2jd(year,month,day)
end
end
end
end
if jd ~= self.p.jd then
self:set_jd(jd)
end
end
function datePrototype:iso()
local ret, str, jd = '', '', self:get_jd()
local year, month, day
if self.p.type=='gregorian' then
year, month, day = self.p.year, self.p.month, self.p.day
else
year, month, day = jd2gregorian(jd)
end
if year < 0 then
year = year - 1
ret = '-'
end
str = tostring(math.abs(year))
return ret .. string.rep('0', 4 - #str) .. str .. '-' .. ((month<10) and '0' or '') .. month .. '-' .. ((day<10) and '0' or '') .. day
end
local function DateWrapper(dt)
local t = {}
t.p = {}
local rop = {
type = false,
mode = true,
jd = false,
timestamp = false,
year = true,
month = true,
day = true,
wday = true,
yday = true,
month_days = true,
leap_year = true
}
local mt = {
__index = function ( tt, k )
assert( t == tt )
local v = tt.p[k] or datePrototype[k]
if v == nil and rop[k] ~=nil then
v = tt:get_value(k)
end
return v
end,
__newindex = function ( t, k, v )
if rop[k] then
error("Attempt to modify read-only property")
elseif k == 'jd' then
t:set_jd(v)
elseif k == 'type' then
t:set_type(v)
elseif k == 'timestamp' then
t:set_timestamp(v)
else
rawset(t, k, v)
end
end
}
-- This is just to make setmetatable() fail
mt.__metatable = mt
return setmetatable( t, mt )
end
local function Date(arg_type, arg_jd, arg_month, arg_day)
local d = DateWrapper({})
-- process argument
d:set_type(arg_type)
if arg_jd and arg_month and arg_day then
d:set_date(arg_jd, arg_month, arg_day)
elseif arg_jd then
d:set_jd(arg_jd)
end
return d
end
return {
gregorian2jd = gregorian2jd,
jd2hijri = jd2hijri,
hijri2jd = hijri2jd,
hijri_days_in_month = hijri_days_in_month,
hijri_isleap = hijri_isleap,
hijri_yday = hijri_yday,
jd2unix = jd2unix,
unix2jd = unix2jd,
jd2wday = jd2wday,
jd2gregorian = jd2gregorian,
gre_isleap = gre_isleap,
gre_yday = gre_yday,
gre_days_in_month = gre_days_in_month,
jd2julian = jd2julian,
julian2jd = julian2jd,
julian_isleap = julian_isleap,
julian_yday = julian_yday,
julian_days_in_month = julian_days_in_month,
gregorian2hijri = gregorian2hijri,
hijri2gregorian = hijri2gregorian,
Date = Date,
hijri_check = hijri_check,
gre_check = gre_check,
julian_check = julian_check
}