وحدة:Year in other calendars/شرح
هذه صفحة توثيق وحدة:Year in other calendars الفرعية، لشرح القالب وتصنيفه، وهي لا تدخل في استخدامه. |
صُنفت هذه الوحدة على أنها في مرحلة بيتا. عندما تصل الوحدة لهذه المرحلة، يمكن أن يوسع استخدامها في الصفحات الأخرى. لكن يجب توخي الحذر من أن الوحدات في هذه المرحلة ما زالت حديثة العهد لذلك وجب توخي الحذر عند الاستخدام وملاحظة أي أخطاء تنتج عنها. من العرف أن المجتمع سوف يوصل الوحدات في هذه المرحلة للتي بعدها عبر صفحات النقاش الخاصة بالوحدة أو أي مكان يعلن عن هذه الوحدة عبر ملاحظة أن هذه الوحدة تعمل بشكل صحيح والجميع راضٍ عن أدائها. |
تقويم ميلادي | 2024 MMXXIV |
تقويم هجري | 1445–1446 |
تقويم هجري شمسي | 1402–1403 |
تقويم أمازيغي | 2974 |
من بداية روما | 2777 |
تقويم أرمني | 1473 ԹՎ ՌՆՀԳ |
تقويم سرياني | 6774 |
تقويم بهائي | 180–181 |
تقويم بنغالي | 1431 |
سنة عرش بريطاني | 72 إليزابيث. 2 – 73 إليزابيث. 2 |
تقويم بوذي | 2568 |
تقويم بورمي | 1386 |
تقويم بيزنطي | 7532–7533 |
تقويم صيني | 癸卯年 (الأرنب المائي) 4720 أو 4660 — إلى — 甲辰年 (التنين الخشبي) 4721 أو 4661 |
تقويم قبطي | 1740–1741 |
تقويم ديسكوردي | 3190 |
تقويم إثيوبي | 2016–2017 |
تقويم عبري | 5784–5785 |
تقويمات هندية | |
- بيكرم سامفات | 2080–2081 |
- شاكا سامفات | 1946–1947 |
- كالي يوغا | 5125–5126 |
تقويم هولوسين | 12024 |
تقويم إغبو | 1024–1025 |
تقويم إيراني | 1402–1403 |
تقويم ياباني | رييوا 6 (令和6年) |
تقويم جوتشي | 113 |
تقويم يولياني | متأخر 13 يوما عن التقويم الميلادي |
تقويم كوري | 4357 |
تقويم مينغوو | 113 على إعلان جمهورية الصين 民國113年 |
تقويم تايلندي | 2567 |
توقيت يونكس | 1704067200–1735689599 |
Adding new calendars
The module is set up to allow for easy addition of new calendars. Just scroll down to the "Build the box" section of the module code, and add your calendar as follows:
To display one year:
local myCalendar = calendar:new()
myCalendar:setLink( 'My calendar article' ) -- The name of the calendar's Wikipedia article.
myCalendar:setYear( year + 10 ) -- Lua code linking the Gregorian calendar year to your calendar's year.
box:addCalendar( myCalendar )
To display a year range:
local myCalendar = calendar:new()
myCalendar:setLink( 'My calendar article' ) -- The name of the calendar's Wikipedia article.
myCalendar:setYearRange( year + 10, year + 11 ) -- Lua code outputting the start year and the end year of the year range.
box:addCalendar( myCalendar )
More complicated calendars can be passed as a string to calendar:setYear()
.
Technical details
The module defines three صنف (حوسبة) which do the work of setting up the sidebar and displaying the data provided by the calendar functions. These are the calendarBox
class, which defines the sidebar; the calendar
class, which holds the data for one calendar; and the calendarGroup
object, which defines a group of calendar objects with a heading.
To load these classes from another module, use the following:
local yearInOtherCalendars = require( 'Module:Year in other calendars' )
local calendarBox = yearInOtherCalendars.calendarBox
local calendarGroup = yearInOtherCalendars.calendarGroup
local calendar = yearInOtherCalendars.calendar
calendarBox class
A calendarBox
object is initiated with:
local myCalendarBox = calendarBox:new{ year = yyyy, footnotes = footnotes, navbar = page name }
year
- sets the Gregorian year to base calendar calculations on. If not specified, the current year is used.footnotes
- sets text to be displayed in a footnotes section at the bottom of the sidebar.navbar
- sets the page name to be used by the قالب:وصلات قالب.
Calendar box objects have the following properties:
calendarBox.year
- the Gregorian year number. This is negative for BC years; for example, for the year 100 BC the value of calendarBox.year is-99
. (BC years are calculated by "1 - n" rather than "0 - n", as there is no year zero.)calendarBox.yearText
- the Gregorian year text. This is a string value of the format "n" for AD years and "n BC" for BC years.calendarBox.caption
- the text of the box caption (the bold text that appears directly above the box). The default caption is the value ofcalendarBox.yearText
.calendarBox.footnotes
- the text of the box footnotes.calendarBox.navbar
- the page name used by the navbar.
Calendar box objects have the following methods:
calendarBox:setCaption( caption )
- sets the box caption (the bold text that appears directly above the box). The default caption is the value ofcalendarBox.yearText
.calendarBox:addCalendar( obj )
- adds a calendar object or a calendar group object to the calendar box.calendarBox:addCalendarGroup( obj )
- an alias formyCalendarBox:addCalendar()
.calendarBox:export()
- converts the calendar box object to wikicode. This callscalendar:export()
andcalendarGroup:export()
to export calendar objects and calendar group objects.
calendar class
A calendar
object is initiated with:
local myCalendar = calendar:new()
Calendar objects have the following properties:
calendar.link
- the link name.calendar.year
- the year value. This is always a string value.
Calendar objects have the following methods:
calendar:setLink( link, display )
- sets the link name for the calendar object.link
is the name of Wikipedia's article about the calendar, anddisplay
is an optional display name for the article link.calendar:setRawLink( wikitext )
- sets the calendar link as raw wikitext.calendar:getLink()
- gets the link value.calendar:setYear( year )
- sets the year value for the calendar.year
can be a number or a string.calendar:setYearRange( startYear, endYear ) - sets the year value for the calendar as a year range. Both
startYear
andendYear
must be number values.calendar:export()
- exports the calendar to wikitext. If no link value was found, this returnsnil
. If a link was found but no year value was found, the calendar is output with a value ofN/A
for the year.
calendarGroup class
A calendarGroup
object is initiated with:
local myCalendarGroup = calendarGroup:new{ heading = heading }
heading
- the wikitext heading for the calendar group (e.g. [[تقويم هندي]]s
).
Calendar group objects have one property:
calendarGroup.heading
- the calendar group heading text.
Calendar group objects have the following methods:
calendarGroup:addCalendar( obj )
- adds a calendar object to the calendar group.
calendarGroup:export()
- converts a calendar group to wikitext. Calls calendar:export()
to export individual calendar objects.
طالع أيضاً