--- title: "Meascáin dáta-bhunaithe" version: 6.0 locale: ga source: https://docs.djangoproject.com/ga/6.0/ref/class-based-views/mixins-date-based/ canonical: https://djangodocs.dev/ga/6.0/ref/class-based-views/mixins-date-based/ --- # Meascáin dáta-bhunaithe > **Note** > > Úsáideann na tréithe formáidithe dáta go léir sna meascáin seo carachtair formáide: func: ~time.strftime. Ná déan iarracht na carachtair formáide a úsáid ón gclib teimpléad:ttag: now mar nach bhfuil siad comhoiriúnach. ## `YearMixin` #### `class YearMixin` Meascán is féidir a úsáid chun faisnéis pháirseála a aisghabháil agus a sholáthar do chomhpháirt bhliain de dháta. Modhanna agus Gnéithe \*\* #### `year_format` An fhormáid: Func: ~time.strftime le húsáid agus an bhliain á pháirseáil. De réir réamhshocraithe, is é seo `'%Y'`. #### `year` **Roghnach** An luach don bhliain, mar shreang. De réir réamhshocraithe, socraigh go None , rud a chiallaíonn go gcinnfear an bhliain ag baint úsáide as modhanna eile. #### `get_year_format()` Filleann sé an fhormáid: func: ~time.strftime le húsáid agus an bhliain á pháirseáil. Tuairisceáin: attr: ~yearMixin.year\_format de réir réamhshocraithe. #### `get_year()` Tugann sé ar ais an bhliain ina dtaispeánfaidh an dearcadh seo sonraí, mar shreang. Déanann triail as na foinsí seo a leanas, in ord: - Luach an tréith: attr: YearMixin.year. - Luach an argóint bliain a ghabhadh sa phatrún URL. - Luach an argóint fiosrúcháin `bliant` GET\`. Ardaíonn sé 404 mura féidir aon sonraíocht bhailí bliana a fháil. #### `get_next_year(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá den bhliain tar éis an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. #### `get_previous_year(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá den bhliain roimh an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. ## `MonthMixin` #### `class MonthMixin` Meascán is féidir a úsáid chun faisnéis pháirseála a aisghabháil agus a sholáthar do chomhpháirt mhí de dháta. Modhanna agus Gnéithe \*\* #### `month_format` An fhormáid: Func: ~time.strftime le húsáid agus an mhí á pháirseáil. De réir réamhshocraithe, is é seo `'%b'`. #### `month` **Roghnaí** An luach don mhí, mar shreang. De réir réamhshocraithe, socraigh go None , rud a chiallaíonn go gcinnfear an mhí ag baint úsáide as modhanna eile. #### `get_month_format()` Filleann sé an fhormáid: func: ~time.strftime le húsáid agus an mhí á pháirseáil. Tuairisceáin: attr: ~MonthMixin.month\_format de réir réamhshocraithe. #### `get_month()` Tugann sé ar ais an mhí a dtaispeánfaidh an dearcadh seo sonraí, mar shreang. Déanann triail as na foinsí seo a leanas, in ord: - Luach an tréith: attr: MonthMixin.Month. - Luach an argóint `mhí` a ghabhadh sa phatrún URL. - Luach an argóint fiosrúcháin ````mhí ```GET````. Ardaíonn sé 404 mura féidir aon sonraíocht bhailí míosa a fháil. #### `get_next_month(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá den mhí tar éis an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. #### `get_previous_month(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá den mhí roimh an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. ## `DayMixin` #### `class DayMixin` Meascán is féidir a úsáid chun faisnéis pháirseála a aisghabháil agus a sholáthar do chomhpháirt lae de dháta. Modhanna agus Gnéithe \*\* #### `day_format` An fhormáid: Func: ~time.strftime le húsáid agus an lá á pháirseáil. De réir réamhshocraithe, is é seo `'%d'`. #### `day` **Roghnaí** An luach don lá, mar shreang. De réir réamhshocraithe, socraigh go None , rud a chiallaíonn go gcinnfear an lá ag baint úsáide as modhanna eile. #### `get_day_format()` Filleann sé an fhormáid: func: ~time.strftime le húsáid agus an lá á pháirseáil. Tuairisceáin: attr: ~daymixin.day\_format de réir réamhshocraithe. #### `get_day()` Tugann sé ar ais an lá dá dtaispeánfaidh an dearcadh seo sonraí, mar shreang. Déanann triail as na foinsí seo a leanas, in ord: - Luach an tréith: attr: DayMixin.day. - Luach an argóint lá gabhadh sa phatrún URL. - Luach an argóint fiosrúcháin ````lá ```GET````. Ardaíonn sé 404 mura féidir aon sonraíocht lae bailí a fháil. #### `get_next_day(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá bailí eile tar éis an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. #### `get_previous_day(date)` Tugann sé réad dáta ina bhfuil an lá bailí roimhe seo ar ais. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. ## `WeekMixin` #### `class WeekMixin` Meascán is féidir a úsáid chun faisnéis pháirseála a aisghabháil agus a sholáthar do chomhpháirt seachtaine de dháta. Modhanna agus Gnéithe \*\* #### `week_format` An fhormáid: Func: ~time.strftime le húsáid agus an tseachtain á pháirseáil. De réir réamhshocraithe, is é seo `'%U'`, rud a chiallaíonn go dtosaíonn an tseachtain Dé Domhnaigh. Socraigh é go `'%W'` nó `` `%V' `` (seachtain ISO 8601) má thosaíonn do sheachtain Dé Luain. #### `week` **Roghnach** An luach don tseachtain, mar shreang. De réir réamhshocraithe, socraigh go None , rud a chiallaíonn go gcinnfear an tseachtain ag baint úsáide as modhanna eile. #### `get_week_format()` Filleann sé an fhormáid: func: ~time.strftime le húsáid agus an tseachtain á pháirseáil. Tuairisceáin: attr: ~weekMixin.week\_format de réir réamhshocraithe. #### `get_week()` Tugann sé ar ais an tseachtain ina dtaispeánfaidh an dearcadh seo sonraí, mar shreang. Déanann triail as na foinsí seo a leanas, in ord: - Luach an tréith: attr: WeekMixin.Week. - Luach an argóint seachtain\` a ghabhadh sa phatrún URL - Luach an argóint fiosrúcháin `` `seachtain `` GET\`. Ardaíonn sé 404 mura féidir aon sonraíocht bhailí seachtaine a fháil. #### `get_next_week(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá den tseachtain tar éis an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. #### `get_prev_week(date)` Tugann sé réad dáta ar ais ina bhfuil an chéad lá den tseachtain roimh an dáta a chuirtear ar fáil. Féadann an fheidhm seo `None` a thabhairt ar ais freisin nó eisceacht:: class: ~django.http.http404 a ardú, ag brath ar luachanna de:attr: ~BasedaTelistView.allow\_empty agus:attr: ~Datemixin.allow\_future. ## `Datemixin` #### `class DateMixin` Rang mixin a sholáthraíonn iompar coitianta do gach tuairim dáta-bhunaithe. Modhanna agus Gnéithe \*\* #### `date_field` Ainm an `DateField` nó `DateTimeField` sa tsamhail `QuerySet` ba chóir don chartlann dáta-bhunaithe a úsáid chun liosta na rudaí atá le taispeáint ar an leathanach a chinneadh. Nuair: doc: cumasaítear tacaíocht crios ama' agus \`\`date\_field\` \ is `DateTimefield`, glactar leis go bhfuil dátaí sa chrios ama reatha. Seachas sin, d'fhéadfadh rudaí ón lá roimhe seo nó an lá dar gcionn a áireamh sa tacar fiosrúcháin i gcrios ama an úsáideora deiridh. > **Warning** > > Sa chás seo, má tá roghnú crios ama in aghaidh an úsáideora curtha i bhfeidhm agat, féadfaidh an URL céanna tacar difriúil rudaí a thaispeáint, ag brath ar chrios ama an úsáideora deiridh. Chun é seo a sheachaint, ba chóir duit `DateField` a úsáid mar an tréith `date_field`. #### `allow_future` Boolean a shonraíonn an gcaithfear rudaí “amach anseo” a áireamh ar an leathanach seo, áit a gciallaíonn “todhchaí” rudaí ina bhfuil an réimse a shonraítear in date\_field\` níos mó ná an dáta/am reatha. De réir réamhshocraithe, is é seo `False`. #### `get_date_field()` Tugann sé ainm an réimse ina bhfuil na sonraí dáta ar a n-oibreoidh an dearcadh seo air. Tuairisceáin: attr: ~DateMixin.Date\_Field de réir réamhshocraithe. #### `get_allow_future()` Faigh amach an gcuirfear rudaí “amach anseo” ar an leathanach seo, áit a chiallaíonn “todhchaí” rudaí ina bhfuil an réimse a shonraítear in date\_field\` níos mó ná an dáta/am reatha. Tuairisceáin: attr: ~DateMixin.allow\_future de réir réamhshocraithe. ## `Basedatelistview` #### `class BaseDateListView` Aicme bonn a sholáthraíonn iompar coitianta do gach tuairim dáta-bhunaithe. De ghnáth ní bheidh cúis ann le instantie:class: ~django.views.generic.dates.basedaListView; ceann de na fo-aicmí a ionad. Cé go bhfuil an dearcadh seo (agus a fho-aicmí) á chur i bhfeidhm, beidh liosta na rudaí a bhfuil an dearcadh ag feidhmiú orthu sa self.object\_list\`, agus beidh liosta na dátaí a bhfuil sonraí ar fáil ina leith `self.date_list`. Meascáin - [`DateMixin`](#django.views.generic.dates.DateMixin) - [`MultipleObjectMixin`](/ga/6.0/ref/class-based-views/mixins-multiple-object/#django.views.generic.list.MultipleObjectMixin) Modhanna agus Gnéithe \*\* #### `allow_empty` Boolean a shonraíonn an bhfuil an leathanach le taispeáint mura bhfuil aon rudaí ar fáil. Más é seo `True` agus nach bhfuil aon rudaí ar fáil, taispeánfaidh an radharc leathanach folamh in ionad 404 a ardú. Tá sé seo comhionann le:attr: Django.Views.Generic.List.MultipleObjectMixin.ALLOW\_EMPTY, ach amháin an luach réamhshocraithe, arb é `False`. #### `date_list_period` **Roghnaí** Sreang a shainmhíníonn an tréimhse comhiomlánaithe le haghaidh `date_list`. Caithfidh sé a bheith ar cheann de 'blian'\` (réamhshocraithe), mhí', nó laeth'. #### `get_dated_items()` Tugann sé tuipéal 3 ar ais ina bhfuil (`date_list`, object\_list\`, extra\_context\`). Is é date\_list\` liosta na dátaí a bhfuil sonraí ar fáil dóibh. Is é `object_list` liosta na rudaí. Is foclóir sonraí comhthéacs é `extra_context` a chuirfear le haon sonraí comhthéacs a sholáthraíonn an:class: ~django.views.generic.list.multipleObjectMixin. #### `get_dated_queryset(**lookup)` Tugann sé tacar ceisteanna ar ais, scagtha ag baint úsáide as na hargóintí ceisteanna a shainmhínítear le `lookup`. Feidhmíonn sé aon srianta ar an tacar fiosrúcháin, mar shampla allow\_empty\` agus allow\_future\`. #### `get_date_list_period()` Tugann sé an tréimhse comhiomlánaithe le haghaidh `date_list`. Tuairisceanna:attr: ~BasedaTelistView.Date\_List\_Period de réir réamhshocraithe. #### `get_date_list(queryset, date_type=None, ordering='ASC')` Tugann sé liosta dátaí den chineál `date_type` a bhfuil iontrálacha ina leith `queryset`. Mar shampla, tabharfaidh ```get_date_list (qs, 'year') ``liosta na mblianta a bhfuil iontrálacha ag ``qs``` ar ais. Mura gcuirtear date\_type\` ar fáil, úsáidtear torth:meth: ~BasedaTelistView.get\_Date\_List\_Period. \Cuirtear `date_type` agus `ordach` chuig: meth: QuerySet.dates () .