कैलेंडर प्रपत्र फ़ील्ड प्रकार
From Joomla! Documentation
'कैलेंडर' फार्म क्षेत्र प्रकार एक तिथि के प्रवेश के लिए एक पाठ बॉक्स प्रदान करता है। एक आइकन टेक्स्ट बॉक्स के बगल में एक पॉप-अप कैलेंडर है, जो भी तारीख मान दर्ज करने के लिए इस्तेमाल किया जा सकता करने के लिए एक लिंक प्रदान करता है। क्षेत्र एक बचाया महत्व है तो इस पाठ बॉक्स में दिखाया गया है। अन्यथा डिफ़ॉल्ट मान, यदि कोई हो, प्रदर्शित किया जाता है।
- 'प्रकार' (अनिवार्य) होना चाहिए कैलेंडर ।
- 'नाम' (अनिवार्य) क्षेत्र की अनूठी नाम है।
- 'लेबल' (अनिवार्य) (अनुवाद) क्षेत्र के वर्णनात्मक शीर्षक है।
- 'डिफ़ॉल्ट' (वैकल्पिक) डिफ़ॉल्ट तारीख है। इस के रूप में प्रारूप तर्क द्वारा निर्दिष्ट एक ही प्रारूप में दिया जाना चाहिए। आप "अब" डाल सकते हैं दिए गए प्रारूप में वर्तमान दिनांक या समय की जानकारी है।
- 'विवरण' (वैकल्पिक) (अनुवाद) पाठ है कि उपयोगकर्ता के टेक्स्ट बॉक्स पर माउस चलता है जब एक टूल टिप के रूप में दिखाया जाएगा।
- 'केवल पढ़ने' (वैकल्पिक) है कि क्या पाठ बॉक्स है केवल पढ़ने के लिए ( सच या गलत )। पाठ बॉक्स केवल पढ़ने के लिए है, तो तारीख बदल नहीं किया जा सकता है, लेकिन चयनित और कॉपी किया जा सकता है। कोई कैलेंडर आइकन दिखाया जाएगा।
- 'विकलांग' (वैकल्पिक) पाठ बॉक्स में अक्षम है कि क्या ( सच या गलत ) है। पाठ बॉक्स अक्षम है, तो तिथि, नहीं बदला जा सकता चयनित या नकल की।
- 'वर्ग' (वैकल्पिक) HTML फार्म क्षेत्र के लिए एक सीएसएस वर्ग के नाम है।
- 'प्रारूप' (वैकल्पिक) तिथि करने के लिए इस्तेमाल किया जा स्वरूप है। इस तिथि स्ट्रिंग प्रारूपों (देखें नीचे) निर्दिष्ट करने के लिए पीएचपी द्वारा इस्तेमाल किया प्रारूप में है। कोई प्रारूप तर्क दिया जाता है, तो '% वाई% m-% d' मान लिया जाता है ( '2008-04-16' की तरह तिथियों दे रही है)।
- 'फिल्टर' (वैकल्पिक) समय इस्तेमाल किया जा रहा क्षेत्र है। दो मानों रहे हैं; server_utc और user_utc। पहले एक सर्वर समय क्षेत्र है और बाद में उपयोगकर्ता समय क्षेत्र क्रमश: वैश्विक विन्यास और उपयोगकर्ता जानकारी में विन्यस्त के रूप में है।
- translateformat (optional): If set to true, the calendar will use the
DATE_FORMAT_CALENDAR_DATE
language key (ifshowtime
is true) orDATE_FORMAT_CALENDAR_DATETIME
(ifshowtime
is false) to determine the format. Theformat
attribute is ignored. If false, theformat
attribute is used (same behaviour as prior to 3.7.0) but note that theformat
string must include time fields for the time to be recorded. Defaults to false. - showtime (optional): If set to true and
translateformat
is true, the language keyDATE_FORMAT_CALENDAR_DATETIME
is used, otherwiseDATE_FORMAT_CALENDAR_DATE
. (starting with 3.7.0). Defaults to false.
- timeformat (optional): can be set to 12 or 24 (starting with 3.7.0). If set to 12, an additional selection is available to the user to choose between AM and PM. This attribute does not affect how the date/time is saved. Defaults to 24.
- singleheader (optional): if set to false, the year and the month selection will be set on two separates lines, with independent selection (starting with 3.7.0). Defaults to false.
- todaybutton (optional): if set to true, a button is added at the bottom of the date picker to select the date of the current day (starting with 3.7.0). Defaults to true.
- weeknumbers (optional): if set to true, a column is added at the left of the date picker to display the number of the week in the current year (starting with 3.7.0). Defaults to true.
- filltable (optional): if set to true, dates of the previous and next month are added at the top and bottom of the current month to fill the grid (starting with 3.7.0). Defaults to true.
- minyear (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative lower limit for the year selection. The user cannot select a year before this limit (starting with 3.7.0). If zero, which is the default, there is no limit.
- maxyear (optional): set a signed integer for a number of years (-10, -2, 0, 7, 12, ...) to define the relative upper limit for the year selection. The user cannot select a year after this limit (starting with 3.7.0). If zero, which is the default, there is no limit.
उदाहरण एक्सएमएल क्षेत्र परिभाषा:
<field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description=""
class="input-small" required="true" filter="user_utc"
showtime="false" todaybutton="false" filltable="false" translateformat="true" />
Example for an advanced DatePicker XML field definition:
<field name="mycalendar" type="calendar" default="2017-05-15" label="Select a date" description=""
class="input-medium" required="true" filter="user_utc" format="%Y-%m-%d %H:%M:%S"
singleheader="true" showtime="true" timeformat="12" todaybutton="true" weeknumbers="true"
filltable="true" minyear="-3" maxyear="5" />
प्रारूप विशेषता प्रारूप उस तारीख स्ट्रिंग में सहेजा जाएगा निर्दिष्ट करता है यह भी स्वरूप है कि दस्ती तारीखों में enterered किए जाने की जरूरत है। सिवाय इसके कि विराम चरित्र को नजरअंदाज कर दिया जाता है। कोडिंग दिनांक स्वरूप निर्दिष्ट करने के लिए इस्तेमाल की योजना एक कस्टम एक datepicker में इस्तेमाल जावास्क्रिप्ट पुस्तकालय के लिए परिभाषित किया गया है, जो की पूरी जानकारी पर उदाहरण के लिए पाया जा सकता है /media/system/js/calendar-uncompressed.js#L1741-L1774 जूमला के Github। निम्नलिखित सबसे अक्सर इस्तेमाल तारीख स्ट्रिंग कोड में से कुछ हैं:
चरित्र | विवरण | उदाहरण |
---|---|---|
d | महीने के दिन, अग्रणी शून्य के साथ 2 अंक | 01 करने के लिए 31 |
a | एक दिन का शाब्दिक प्रतिनिधित्व, तीन पत्र | सूर्य के माध्यम से सोम |
e | अग्रणी शून्य के बिना महीने का दिन | 01 करने के लिए 31 |
A | सप्ताह के दिन का पूरा मूलपाठ का प्रतिनिधित्व | सोमवार से रविवार |
w | सप्ताह के दिन के संख्यात्मक प्रतिनिधित्व | (रविवार के लिए) 0 6 (शनिवार के लिए) के माध्यम से |
j | साल के दिन (0 से शुरू) | 366 के माध्यम से 001 |
B | एक महीने की एक पूरी शाब्दिक प्रतिनिधित्व | दिसम्बर के माध्यम से जनवरी |
m | एक महीने के संख्यात्मक प्रतिनिधित्व, अग्रणी शून्य के साथ | 01 के माध्यम से 12 |
b | एक महीने के एक छोटे से शाब्दिक प्रतिनिधित्व, तीन पत्र | दिसम्बर के माध्यम से जन |
Y | एक वर्ष की एक पूर्ण संख्यात्मक प्रतिनिधित्व, 4 अंक | 1999 या 2003 |
y | एक वर्ष की एक दो अंकों प्रतिनिधित्व | 99 या 03 |
P | लोअर केस प्रात या दोपहर के बाद | पूर्वाह्न या अपराह्न |
p | अपरकेस प्रात या दोपहर के बाद | पूर्वाह्न या अपराह्न |
नोट: प्रारूप है जिसमें तारीखों params.ini फाइल में जमा हो जाती है कि प्रारूप तर्क द्वारा निर्दिष्ट है। के बाद से वहाँ (उदाहरण के लिए, '% ए' विनिर्देशक के लिए) इस प्रारूप के लिए भाषा पर निर्भर तत्व हो सकते हैं, आप अगर वहाँ एक संभावना सामने के अंत और पीछे के अंत भाषाओं में हो सकता है वह यह है कि इस तरह के तत्वों का उपयोग नहीं करने के लिए सावधान रहने की जरूरत विभिन्न।
नोट: कैलेंडर प्रपत्र फ़ील्ड प्रकार के गैर-ग्रेगोरियन कैलेंडर का समर्थन नहीं करता। आप गैर-ग्रेगोरियन कैलेंडर के समर्थन की जरूरत है, तो आप अपने कैलेंडर का समर्थन करने के लिए एक कस्टम प्रपत्र फ़ील्ड प्रकार बनाने की आवश्यकता होगी।
स्टैंडर्ड जुड़े फिल्टर
- 'उपयोगकर्ता _ यूटीसी' - ग्रीनविच समय पर निर्धारित मूल्य से गणना करता है, उपयोगकर्ता समय क्षेत्र सेटिंग्स के अनुसार।