Django 2.1 - Date-based mixins

तिथि-आधारित मिश्रण




django

तिथि-आधारित मिश्रण

ध्यान दें

इन मिश्रणों में सभी दिनांक स्वरूपण विशेषताएँ strftime() प्रारूप वर्णों का उपयोग करती हैं। संगत टेम्पलेट टैग प्रारूप का उपयोग करने की कोशिश न करें क्योंकि वे संगत नहीं हैं।

YearMixin

class YearMixin [source]

एक मिश्रण जिसे किसी तिथि के एक वर्ष के घटक के लिए पार्सिंग जानकारी प्राप्त करने और प्रदान करने के लिए उपयोग किया जा सकता है।

तरीके और गुण

year_format

वर्ष का उपयोग करते समय उपयोग करने के लिए strftime() प्रारूप। डिफ़ॉल्ट रूप से, यह '%Y'

year

वैकल्पिक एक स्ट्रिंग के रूप में वर्ष के लिए मूल्य। डिफ़ॉल्ट रूप से, None सेट None , जिसका अर्थ है कि अन्य साधनों का उपयोग करके वर्ष निर्धारित किया जाएगा।

get_year_format() [source]

वर्ष strftime() करते समय उपयोग करने के लिए strftime() प्रारूप लौटाता है। डिफ़ॉल्ट रूप से year_format लौटाता है।

get_year() [source]

वह वर्ष जिस पर यह दृश्य डेटा प्रदर्शित करेगा, स्ट्रिंग के रूप में। निम्न स्रोतों को क्रम में रखता है:

  • YearMixin.year विशेषता का मान।
  • URL पैटर्न में कैप्चर किए गए year तर्क का मान।
  • वर्ष का मान क्वेरी तर्क GET है।

यदि कोई वैध वर्ष विनिर्देश नहीं पाया जा सकता है तो एक 404 उठाता है।

get_next_year(date) [source]

प्रदान की गई तारीख के बाद वर्ष के पहले दिन युक्त एक दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

get_previous_year(date) [source]

उपलब्ध कराई गई तारीख से पहले वर्ष के पहले दिन युक्त एक दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

MonthMixin

class MonthMixin [source]

एक मिश्रण जिसे एक महीने के घटक के लिए पार्सिंग जानकारी प्राप्त करने और प्रदान करने के लिए इस्तेमाल किया जा सकता है।

तरीके और गुण

month_format

महीने को पार्स करते समय उपयोग करने के लिए strftime() प्रारूप। डिफ़ॉल्ट रूप से, यह '%b'

month

वैकल्पिक एक स्ट्रिंग के रूप में महीने के लिए मूल्य। डिफ़ॉल्ट रूप से, None सेट None , जिसका अर्थ है कि अन्य साधनों का उपयोग करके महीना निर्धारित किया जाएगा।

get_month_format() [source]

महीने को पार्स करते समय उपयोग करने के लिए strftime() प्रारूप लौटाता है। डिफ़ॉल्ट रूप से month_format लौटाता है।

get_month() [source]

वह महीना लौटाता है जिसके लिए यह दृश्य एक स्ट्रिंग के रूप में डेटा प्रदर्शित करेगा। निम्न स्रोतों को क्रम में रखता है:

  • MonthMixin.month विशेषता का मान।
  • URL पैटर्न में कैप्चर किए गए month तर्क का मूल्य।
  • month का मान क्वेरी तर्क मिलता है।

यदि कोई वैध महीना विनिर्देशन नहीं मिल पाता है तो 404 उठाता है।

get_next_month(date) [source]

प्रदान की गई तारीख के बाद महीने के पहले दिन युक्त एक दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

get_previous_month(date) [source]

उपलब्ध कराई गई तारीख से पहले महीने के पहले दिन युक्त एक दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

DayMixin

class DayMixin [source]

एक मिश्रण जिसे किसी तिथि के एक दिन के घटक के लिए पार्सिंग जानकारी प्राप्त करने और प्रदान करने के लिए उपयोग किया जा सकता है।

तरीके और गुण

day_format

दिन को पार्स करते समय उपयोग करने के लिए strftime() प्रारूप। डिफ़ॉल्ट रूप से, यह '%d'

day

वैकल्पिक एक स्ट्रिंग के रूप में दिन के लिए मूल्य। डिफ़ॉल्ट रूप से, None सेट None , जिसका अर्थ है कि दिन अन्य साधनों का उपयोग करके निर्धारित किया जाएगा।

get_day_format() [source]

दिन को पार्स करते समय उपयोग करने के लिए strftime() प्रारूप लौटाता है। डिफ़ॉल्ट रूप से day_format लौटाता है।

get_day() [source]

वह दिन लौटाता है जिसके लिए यह दृश्य एक स्ट्रिंग के रूप में डेटा प्रदर्शित करेगा। निम्न स्रोतों को क्रम में रखता है:

  • DayMixin.day विशेषता का मान।
  • URL पैटर्न में कैप्चर किए गए day तर्क का मूल्य।
  • day का मान क्वेरी तर्क मिलता है।

अगर कोई वैध दिन विनिर्देश नहीं मिल पाता है तो 404 उठाता है।

get_next_day(date) [source]

प्रदान की गई तारीख के बाद अगले वैध दिन वाले दिनांक ऑब्जेक्ट को लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

get_previous_day(date) [source]

पिछले मान्य दिन युक्त दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

WeekMixin

class WeekMixin [source]

एक मिश्रण जिसे एक तिथि के एक सप्ताह के घटक के लिए पार्सिंग जानकारी प्राप्त करने और प्रदान करने के लिए इस्तेमाल किया जा सकता है।

तरीके और गुण

week_format

सप्ताह को पार्स करते समय उपयोग करने के लिए strftime() प्रारूप। डिफ़ॉल्ट रूप से, यह '%U' , जिसका अर्थ है कि सप्ताह रविवार से शुरू होगा। यदि आपका सप्ताह सोमवार को शुरू होता है, तो इसे '%W' सेट करें।

week

वैकल्पिक एक स्ट्रिंग के रूप में सप्ताह के लिए मूल्य। डिफ़ॉल्ट रूप से, None सेट None , जिसका अर्थ है कि अन्य साधनों का उपयोग करके सप्ताह निर्धारित किया जाएगा।

get_week_format() [source]

सप्ताह को पार्स करते समय उपयोग करने के लिए strftime() प्रारूप लौटाता है। week_format डिफ़ॉल्ट रूप से देता है।

get_week() [source]

वह सप्ताह लौटाता है जिसके लिए यह दृश्य एक स्ट्रिंग के रूप में डेटा प्रदर्शित करेगा। निम्न स्रोतों को क्रम में रखता है:

  • WeekMixin.week विशेषता का मान।
  • URL पैटर्न में कैप्चर किए गए week तर्क का मान
  • week का मान क्वेरी तर्क GET

यदि कोई वैध सप्ताह विनिर्देश नहीं पाया जा सकता है, तो एक 404 उठाता है।

get_next_week(date) [source]

उपलब्ध कराई गई तारीख के बाद सप्ताह के पहले दिन युक्त एक दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

get_prev_week(date)

उपलब्ध कराई गई तारीख से पहले सप्ताह के पहले दिन युक्त एक दिनांक ऑब्जेक्ट लौटाता है। यह फ़ंक्शन allow_empty और allow_future के मूल्यों के आधार पर, None भी None लौट सकता है या एक Http404 अपवाद बढ़ा allow_future

DateMixin

class DateMixin [source]

एक मिश्रित वर्ग जो सभी तिथि-आधारित विचारों के लिए सामान्य व्यवहार प्रदान करता है।

तरीके और गुण

date_field

DateField मॉडल में DateField या DateTimeField का नाम जो दिनांक-आधारित संग्रह को पृष्ठ पर प्रदर्शित करने के लिए ऑब्जेक्ट की सूची निर्धारित करने के लिए उपयोग करना चाहिए।

जब समय क्षेत्र समर्थन सक्षम होता है और date_field DateTimeField , तो तिथियां वर्तमान समय क्षेत्र में मान ली जाती हैं। अन्यथा, क्वेरीसेट अंत उपयोगकर्ता के समय क्षेत्र में पिछले या अगले दिन से वस्तुओं को शामिल कर सकता है।

चेतावनी

इस स्थिति में, यदि आपने प्रति-उपयोगकर्ता समय क्षेत्र चयन को लागू किया है, तो एक ही URL अंत समय के समय क्षेत्र के आधार पर, वस्तुओं का एक अलग सेट दिखा सकता है। इससे बचने के लिए, आपको DateField विशेषता के रूप में एक DateField उपयोग करना चाहिए।

allow_future

एक बूलियन निर्दिष्ट करता है कि इस पृष्ठ पर "भविष्य" वस्तुओं को शामिल करना है, जहां "भविष्य" का मतलब उन वस्तुओं से है जिसमें date_field में निर्दिष्ट फ़ील्ड वर्तमान दिनांक / समय से अधिक है। डिफ़ॉल्ट रूप से, यह False

get_date_field() [source]

उस फ़ील्ड का नाम लौटाता है जिसमें वह दिनांक डेटा होता है जिस पर यह दृश्य काम करेगा। डिफ़ॉल्ट रूप से date_field लौटाता है।

get_allow_future() [source]

निर्धारित करें कि क्या इस पृष्ठ पर "भविष्य" वस्तुओं को शामिल किया जाए, जहां "भविष्य" का अर्थ उन वस्तुओं से है जिसमें date_field में निर्दिष्ट फ़ील्ड वर्तमान दिनांक / समय से अधिक है। डिफ़ॉल्ट रूप से allow_future लौटाता है।

BaseDateListView

class BaseDateListView [source]

एक आधार वर्ग जो सभी तिथि-आधारित विचारों के लिए सामान्य व्यवहार प्रदान करता है। आम तौर पर BaseDateListView को BaseDateListView कोई कारण नहीं होगा; इसके बजाय उपवर्गों में से किसी एक को तत्काल करें।

हालांकि यह दृश्य (और इसके उपवर्ग) निष्पादित कर रहे हैं, self.object_list में उन वस्तुओं की सूची होगी जो दृश्य चल रही है, और self.date_list में उन तिथियों की सूची होगी जिनके लिए डेटा उपलब्ध है।

mixins

तरीके और गुण

allow_empty

एक बूलियन निर्दिष्ट करता है कि यदि कोई वस्तु उपलब्ध नहीं है तो पृष्ठ प्रदर्शित करना है या नहीं। यदि यह True और कोई वस्तु उपलब्ध नहीं है, तो दृश्य 404 को ऊपर उठाने के बजाय एक खाली पृष्ठ प्रदर्शित करेगा।

यह डिफ़ॉल्ट मान को छोड़कर django.views.generic.list.MultipleObjectMixin.allow_empty समान है, जो कि False

date_list_period

वैकल्पिक date_list लिए एकत्रीकरण अवधि को परिभाषित करने वाला एक स्ट्रिंग। यह 'year' (डिफ़ॉल्ट), 'month' या 'day' से एक होना चाहिए।

get_dated_items() [source]

एक 3-टपल युक्त रिटर्न ( date_list , object_list , extra_context )।

date_list उन date_list की सूची है, जिनके लिए डेटा उपलब्ध है। object_list वस्तुओं की सूची है। extra_context एक संदर्भ डेटा का शब्दकोश है, जिसे MultipleObjectMixin द्वारा प्रदान किए गए किसी भी संदर्भ डेटा में जोड़ा जाएगा।

get_dated_queryset(**lookup) [source]

lookup द्वारा परिभाषित क्वेरी तर्कों का उपयोग करके एक क्वेरीसेट, फ़िल्टर्ड लौटाता है। क्वेरीसेट पर किसी भी प्रतिबंध को लागू करता है, जैसे allow_empty और allow_future

get_date_list_period() [source]

date_list लिए एकत्रीकरण अवधि date_list । डिफ़ॉल्ट रूप से date_list_period लौटाता है।

get_date_list(queryset, date_type=None, ordering='ASC') [source]

उस प्रकार की तारीखों की सूची लौटाता है जिसके लिए date_type है जिसमें date_type में प्रविष्टियाँ हैं। उदाहरण के लिए, get_date_list(qs, 'year') उन वर्षों की सूची लौटाएगा जिनके लिए qs की प्रविष्टियाँ हैं। यदि date_type प्रदान नहीं किया गया है, तो get_date_list_period() के परिणाम का उपयोग किया जाता है। date_type और ordering को केवल QuerySet.dates()