{"title":"Tuairimí dáta cineálacha","version":"6.0","locale":"ga","docname":"ref/class-based-views/generic-date-based","url":"/ga/6.0/ref/class-based-views/generic-date-based/","canonical":"https://djangodocs.dev/ga/6.0/ref/class-based-views/generic-date-based/","summary":"Is tuairimí iad tuairimí cineálacha dáta-bhunaithe, a chuirtear ar fáil in:mod: django.views.generic.dates, chun leathanaigh druileála síos a thaispeáint le…","html":"

Tuairimí dáta cineálachaLink to this heading#

\n

Is tuairimí iad tuairimí cineálacha dáta-bhunaithe, a chuirtear ar fáil in:mod: django.views.generic.dates, chun leathanaigh druileála síos a thaispeáint le haghaidh sonraí dáta-bhunaithe.

\n\n
\n

ArchiveIndexViewLink to this heading#

\n
\n
\nclass ArchiveIndexViewLink to this definition#
\n

Leathanach innéacs barrleibhéil a thaispeánann na rudaí “is déanaí”, de réir dáta. Ní chuirtear rudaí le dáta san todhchaí san áireamh mura socraíonn tú allow_future go True.

\n

**Sinsear (MRO) **

\n\n

Comhthéacs

\n

Chomh maith leis an gcomhthéacs a sholáthraí:class: Django.Views.Generic.List.MultipleObjectMixin (via:class: Django.Views.Generic.DateListView), beidh comhthéacs an teimpléid ná:

\n
    \n

  • date_list: A:Meth: QuerySet `réad ina bhfuil gach bli <django.db.models.query.QuerySet.dates>ain a bhfuil rudaí ar fáil de réir ``queryset`, a léirítear mar: class: datetime.datetime rudaí, in ord íslitheach.

    • \n
\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe context_object_name de latest.

    • \n

  • Úsáideann sé réamhshocraithe template_name_suffix de _archive.

    • \n

  • Réamhshocraithe chun date_list` a sholáthar de réir bliana, ach is féidir é seo a athrú go mí nó go lá ag baint úsáide as an tréith date_list_period. Baineann sé seo freisin le tuairimí fo-aicme go léir.

    • \n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\nfrom django.views.generic.dates import ArchiveIndexView\n\nfrom myapp.models import Article\n\nurlpatterns = [\n    path(\n        "archive/",\n        ArchiveIndexView.as_view(model=Article, date_field="pub_date"),\n        name="article_archive",\n    ),\n]\n
\n

Sampla myapp/article_archive.html:

\n
Django template
<ul>\n    {% for article in latest %}\n        <li>{{ article.pub_date }}: {{ article.title }}</li>\n    {% endfor %}\n</ul>\n
\n

Aschuirfidh sé seo gach alt.

\n
\n\n
\n
\n

``EarthArchiveView ``Link to this heading#

\n
\n
\nclass YearArchiveViewLink to this definition#
\n

Leathanach cartlainne bliantúil a thaispeánann gach míonna atá ar fáil i mbliain áirithe. Ní thaispeántar rudaí le dáta san todhchaí mura socraíonn tú allow_future go True`.

\n

**Sinsear (MRO) **

\n\n
\n
\nmake_object_listLink to this definition#
\n

Boolean a shonraíonn an liosta iomlán rudaí a aisghabháil don bhliain seo agus iad sin a chur chuig an teimpléad. Má tá “Fíor”, cuirfear liosta na rudaí ar fáil don chomhthéacs. Má tá False, úsáidfear an tacar ceisteanna None mar liosta na rudaí. De réir réamhshocraithe, is é seo False.

\n
\n\n
\n
\nget_make_object_list()Link to this definition#
\n

Faigh amach an gcuirfear liosta rudaí ar ais mar chuid den chomhthéacs. Tuairisceanna:attr: ~yearArchiveView.make_object_list de réir réamhshocraithe.

\n
\n\n

Comhthéacs

\n

Chomh maith leis an gcomhthéacs a sholáthraí:class: Django.Views.Generic.List.MultipleObjectMixin (via:class: Django.Views.Generic.DateListView), beidh comhthéacs an teimpléid ná:

\n
    \n

  • date_list: A:Meth: QuerySet `réad ina bhfuil gach mí <django.db.models.query.QuerySet.dates>onna a bhfuil rudaí ar fáil de réir ``queryset`, a léirítear mar: class: datetime.datetime rudaí, in ord ardaitheach.

    • \n

  • ``bliain ``: A: Class: ~datetime.date réad a léiríonn an bhliain ar leith.

    • \n

  • next_year: a: Class: ~datetime.date réad a léiríonn an chéad lá den bhliain seo chugainn, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n

  • ``roimh_bliain ``: A: Class: ~datetime.date réad a léiríonn an chéad lá den bhliain roimhe sin, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n
\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe template_name_suffix de _archive_year.

    • \n
\n

Sampla myapp/views.py:

\n
Code
from django.views.generic.dates import YearArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleYearArchiveView(YearArchiveView):\n    queryset = Article.objects.all()\n    date_field = "pub_date"\n    make_object_list = True\n    allow_future = True\n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\n\nfrom myapp.views import ArticleYearArchiveView\n\nurlpatterns = [\n    path("<int:year>/", ArticleYearArchiveView.as_view(), name="article_year_archive"),\n]\n
\n

Sampla myapp/article_archive_year.html:

\n
Django template
<ul>\n    {% for date in date_list %}\n        <li>{{ date|date }}</li>\n    {% endfor %}\n</ul>\n\n<div>\n    <h1>All Articles for {{ year|date:"Y" }}</h1>\n    {% for obj in object_list %}\n        <p>\n            {{ obj.title }} - {{ obj.pub_date|date:"F j, Y" }}\n        </p>\n    {% endfor %}\n</div>\n
\n
\n\n
\n
\n

``MonthArchiveView ``Link to this heading#

\n
\n
\nclass MonthArchiveViewLink to this definition#
\n

Leathanach cartlainne míosúil a thaispeánann gach rud i mí ar leith. Ní thaispeántar rudaí le dáta san todhchaí mura socraíonn tú allow_future go True`.

\n

**Sinsear (MRO) **

\n\n

Comhthéacs

\n

Chomh maith leis an gcomhthéacs a sholáthraí:class: ~Django.Views.Generic.List.MultipleObjectMixin (via:class: ~Django.Views.Generic.Dates.BasedaListView), beidh comhthéacs an teimpléid ná:

\n
    \n

  • date_list: A:Meth: QuerySet `réad ina bhfuil gach <django.db.models.query.QuerySet.dates>lá a bhfuil rudaí ar fáil sa mhí ar leith, de réir ``queryset`, a léirítear mar: class: datetime.datetime rudaí, in ord ardaitheach.

    • \n

  • Month: A: Class: ~datetime.date réad a léiríonn an mhí ar leith.

    • \n

  • ``next_month ``: A: Class: ~datetime.date réad a léiríonn an chéad lá den mhí seo chugainn, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n

  • ``previous_month ``: A: Class: ~datetime.date réad a léiríonn an chéad lá den mhí roimhe sin, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n
\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe template_name_suffix de ``_archive_month ``.

    • \n
\n

Sampla myapp/views.py:

\n
Code
from django.views.generic.dates import MonthArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleMonthArchiveView(MonthArchiveView):\n    queryset = Article.objects.all()\n    date_field = "pub_date"\n    allow_future = True\n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\n\nfrom myapp.views import ArticleMonthArchiveView\n\nurlpatterns = [\n    # Example: /2012/08/\n    path(\n        "<int:year>/<int:month>/",\n        ArticleMonthArchiveView.as_view(month_format="%m"),\n        name="archive_month_numeric",\n    ),\n    # Example: /2012/aug/\n    path(\n        "<int:year>/<str:month>/",\n        ArticleMonthArchiveView.as_view(),\n        name="archive_month",\n    ),\n]\n
\n

Sampla myapp/article_archive_month.html:

\n
Django template
<ul>\n    {% for article in object_list %}\n        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>\n    {% endfor %}\n</ul>\n\n<p>\n    {% if previous_month %}\n        Previous Month: {{ previous_month|date:"F Y" }}\n    {% endif %}\n    {% if next_month %}\n        Next Month: {{ next_month|date:"F Y" }}\n    {% endif %}\n</p>\n
\n
\n\n
\n
\n

``WeekArchiveView ``Link to this heading#

\n
\n
\nclass WeekArchiveViewLink to this definition#
\n

Leathanach cartlainne seachtainiúil a thaispeánann gach rud i seachtain ar leith. Ní thaispeántar rudaí le dáta san todhchaí mura socraíonn tú allow_future go True`.

\n

**Sinsear (MRO) **

\n\n

Comhthéacs

\n

Chomh maith leis an gcomhthéacs a sholáthraí:class: ~Django.Views.Generic.List.MultipleObjectMixin (via:class: ~Django.Views.Generic.Dates.BasedaListView), beidh comhthéacs an teimpléid ná:

\n
    \n

  • ``seachtain`: A:Class: ~datetime.date réad a léiríonn an chéad lá den tseachtain ar leith.

    • \n

  • ``next_week ``: A: Class: ~datetime.date réad a léiríonn an chéad lá den tseachtain seo chugainn, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n

  • seachtain_roimh: A: Class: ~datetime.date réad a léiríonn an chéad lá den tseachtain roimhe sin, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~DateMixin.allow_future.

    • \n
\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe template_name_suffix de _archive_week.

    • \n

  • Is é an tréith week_format:: func: ~time.strptime teaghrán formáid a úsáidtear chun uimhir na seachtaine a pháirseáil. Tacaítear leis na luachanna seo a leanas:

    \n
      \n

    • '%U': Bunaithe ar chóras seachtaine na Stát Aontaithe ina dtosaíonn an tseachtain Dé Domhnaigh. Is é seo an luach réamhshocraithe.

      • \n

    • '%W': Cosúil le '%U', ach amháin glacann sé leis go dtosaíonn an tseachtain Dé Luain. Níl sé seo mar an gcéanna leis an uimhir seachtaine ISO 8601.

      • \n

    • '%V': ISO 8601 uimhir seachtaine ina dtosaíonn an tseachtain Dé Luain.

      • \n
    \n
    • \n
\n

Sampla myapp/views.py:

\n
Code
from django.views.generic.dates import WeekArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleWeekArchiveView(WeekArchiveView):\n    queryset = Article.objects.all()\n    date_field = "pub_date"\n    week_format = "%W"\n    allow_future = True\n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\n\nfrom myapp.views import ArticleWeekArchiveView\n\nurlpatterns = [\n    # Example: /2012/week/23/\n    path(\n        "<int:year>/week/<int:week>/",\n        ArticleWeekArchiveView.as_view(),\n        name="archive_week",\n    ),\n]\n
\n

Sampla myapp/article_archive_week.html:

\n
Django template
<h1>Week {{ week|date:'W' }}</h1>\n\n<ul>\n    {% for article in object_list %}\n        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>\n    {% endfor %}\n</ul>\n\n<p>\n    {% if previous_week %}\n        Previous Week: {{ previous_week|date:"W" }} of year {{ previous_week|date:"Y" }}\n    {% endif %}\n    {% if previous_week and next_week %}--{% endif %}\n    {% if next_week %}\n        Next week: {{ next_week|date:"W" }} of year {{ next_week|date:"Y" }}\n    {% endif %}\n</p>\n
\n

Sa sampla seo, tá tú ag cur uimhir na seachtaine. Coinnigh i gcuimhne nach bhfuil uimhreacha seachtaine arna ríomh ag an scagaire teimpléad:tfilter: dáta leis an gcarachtar formáid 'W' mar an gcéanna i gcónaí leis na huimhreacha a ríomhaítear ar:func: ~time.strftime agus:func: ~time.strptime leis an teaghrán formáid '%W'`. Maidir le bliain 2015, mar shampla, tá uimhreacha seachtaine a aschuirtear ag: tfilter: `dáta` níos airde ceann amháin i gcomparáid leis na haschuir sin ag: func: `~time.strftime`. Níl coibhéis ann don teaghrán formáid `'%u':func: `~time.strftime in:tfilter: dáta. Dá bhrí sin, ba chóir duit: tfilter: dáta a sheachaint chun URLanna a ghiniúint do WeekArchiveView `.

\n
\n\n
\n
\n

DayArchiveViewLink to this heading#

\n
\n
\nclass DayArchiveViewLink to this definition#
\n

Leathanach cartlainne lae a thaispeánann gach rud i lá ar leith. Caitheann laethanta amach anseo earráid 404, is cuma an bhfuil aon rudaí ann do laethanta amach anseo, mura socraíonn tú allow_future go True`.

\n

**Sinsear (MRO) **

\n\n

Comhthéacs

\n

Chomh maith leis an gcomhthéacs a sholáthraí:class: ~Django.Views.Generic.List.MultipleObjectMixin (via:class: ~Django.Views.Generic.Dates.BasedaListView), beidh comhthéacs an teimpléid ná:

\n
    \n

  • day: A: Class: ~datetime.date réad a léiríonn an lá ar leith.

    • \n

  • next_day: a: Class: ~datetime.date réad a léiríonn an lá dar gcionn, de réir: attr: ~basedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n

  • ``Preious_day ``: A: Class: ~datetime.date réad a léiríonn an lá roimhe sin, de réir: attr: ~basedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n

  • ``next_month ``: A: Class: ~datetime.date réad a léiríonn an chéad lá den mhí seo chugainn, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n

  • ``previous_month ``: A: Class: ~datetime.date réad a léiríonn an chéad lá den mhí roimhe sin, de réir: attr: ~BasedaTelistView.allow_empty agus:attr: ~Datemixin.allow_future.

    • \n
\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe template_name_suffix de _archive_day.

    • \n
\n

Sampla myapp/views.py:

\n
Code
from django.views.generic.dates import DayArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleDayArchiveView(DayArchiveView):\n    queryset = Article.objects.all()\n    date_field = "pub_date"\n    allow_future = True\n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\n\nfrom myapp.views import ArticleDayArchiveView\n\nurlpatterns = [\n    # Example: /2012/nov/10/\n    path(\n        "<int:year>/<str:month>/<int:day>/",\n        ArticleDayArchiveView.as_view(),\n        name="archive_day",\n    ),\n]\n
\n

Sampla myapp/article_archive_day.html:

\n
Django template
<h1>{{ day }}</h1>\n\n<ul>\n    {% for article in object_list %}\n        <li>{{ article.pub_date|date:"F j, Y" }}: {{ article.title }}</li>\n    {% endfor %}\n</ul>\n\n<p>\n    {% if previous_day %}\n        Previous Day: {{ previous_day }}\n    {% endif %}\n    {% if previous_day and next_day %}--{% endif %}\n    {% if next_day %}\n        Next Day: {{ next_day }}\n    {% endif %}\n</p>\n
\n
\n\n
\n
\n

``TodayArchiveView ``Link to this heading#

\n
\n
\nclass TodayArchiveViewLink to this definition#
\n

Leathanach cartlainne lae a thaispeánann gach rud le haghaidh inneo. Tá sé seo díreach mar an gcéanna len:class: Django.Views.Generic.Dates.DayArchiveView, ach amháin go n-úsáidtear dáta an lae inniu in ionad na hargóintí bliant/mhí ````/lá `.

\n

**Sinsear (MRO) **

\n\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe template_name_suffix de _archive_today.

    • \n
\n

Sampla myapp/views.py:

\n
Code
from django.views.generic.dates import TodayArchiveView\n\nfrom myapp.models import Article\n\n\nclass ArticleTodayArchiveView(TodayArchiveView):\n    queryset = Article.objects.all()\n    date_field = "pub_date"\n    allow_future = True\n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\n\nfrom myapp.views import ArticleTodayArchiveView\n\nurlpatterns = [\n    path("today/", ArticleTodayArchiveView.as_view(), name="archive_today"),\n]\n
\n\n
\n\n
\n
\n

DáteDetailviewLink to this heading#

\n
\n
\nclass DateDetailViewLink to this definition#
\n

Leathanach a léiríonn réad aonair. Má tá luach dáta ag an réad sa todhchaí, caithfidh an dearcadh earráid 404 de réir réamhshocraithe, mura socraíonn tú allow_future go True`.

\n

**Sinsear (MRO) **

\n\n

Comhthéacs

\n
    \n

  • Cuimsíonn sé an réad aonair a bhaineann leis an samhail ``a shonraítear sa `DateDetailView.

    • \n
\n

Nótaí

\n
    \n

  • Úsáideann sé réamhshocraithe template_name_suffix de _detail.

    • \n
\n

Sampla myapp/urls.py:

\n
Code
from django.urls import path\nfrom django.views.generic.dates import DateDetailView\n\nurlpatterns = [\n    path(\n        "<int:year>/<str:month>/<int:day>/<int:pk>/",\n        DateDetailView.as_view(model=Article, date_field="pub_date"),\n        name="archive_date_detail",\n    ),\n]\n
\n

Sampla myapp/article_detail.html:

\n
Django template
<h1>{{ object.title }}</h1>\n
\n
\n\n\n
","rootId":"module-django.views.generic.dates","toc":[{"title":"ArchiveIndexView","anchor":"archiveindexview","children":[]},{"title":"``EarthArchiveView ``","anchor":"yeararchiveview","children":[]},{"title":"``MonthArchiveView ``","anchor":"montharchiveview","children":[]},{"title":"``WeekArchiveView ``","anchor":"weekarchiveview","children":[]},{"title":"DayArchiveView","anchor":"dayarchiveview","children":[]},{"title":"``TodayArchiveView ``","anchor":"todayarchiveview","children":[]},{"title":"DáteDetailview","anchor":"datedetailview","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Tagairt API","url":"/ga/6.0/ref/"},{"docname":"ref/class-based-views/index","title":"API tuairimí rang-bhunaithe ionsuite","url":"/ga/6.0/ref/class-based-views/"}],"prev":{"docname":"ref/class-based-views/generic-editing","title":"Tuairimí eagarthóireachta","url":"/ga/6.0/ref/class-based-views/generic-editing/"},"next":{"docname":"ref/class-based-views/mixins","title":"Meascáin tuairimí rang-bhunaithe","url":"/ga/6.0/ref/class-based-views/mixins/"},"formats":{"html":"/ga/6.0/ref/class-based-views/generic-date-based/","markdown":"/ga/6.0/ref/class-based-views/generic-date-based.md","json":"/ga/6.0/ref/class-based-views/generic-date-based.json"},"source":"https://github.com/django/django/blob/stable/6.0.x/docs/ref/class-based-views/generic-date-based.txt","official":"https://docs.djangoproject.com/ga/6.0/ref/class-based-views/generic-date-based/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}