Tampilan umum berdasarkan-tanggal, disediakan di django.views.generic.dates, adalah tampilan untuk menampilkan halaman-halaman penelusuran untuk data berdasarkan-tanggal.
ArchiveIndexViewLink to this heading#Halaman indeks tingkat-atas menampilkan obyek "latest", berdasarkan tanggal. Obyek dengan sebuah tanggal di future tidak disertakan meskipun anda menyetel allow_future menjadi True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Konteks
\nSebagai tambahan pada konteks disediakan oleh django.views.generic.list.MultipleObjectMixin (melalui django.views.generic.dates.BaseDateListView), konteks cetakan akan menjadi:
date_list: Sebuah obyek QuerySet mengandung semua tahun yang mempunyai obyek-obyek tersedia menurut pada queryset, diwakili sebagai obyek datetime.datetime, dalam urutan menurun.
Catatan
\nMenggunakan context_object_name awal dari latest.
Menggunakan template_name_suffix awal dari _archive.
Awalan untuk menyediakan date_list berdasarkan tahun, tetapi ini dapat dirubah menjadi bulan atau hari menggunakan atribut date_list_period. Ini juga memberlakukan ke semua tampilan subkelas.
Contoh myapp/urls.py:
\nfrom 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]\nContoh myapp/article_archive.html:
\n<ul>\n {% for article in latest %}\n <li>{{ article.pub_date }}: {{ article.title }}</li>\n {% endfor %}\n</ul>\nIni akan mengeluarkan semua artikel.
\nYearArchiveViewLink to this heading#Halaman arsip tahunan menampilkan semua bulan tersedia di tahun yang diberikan. Obyek-obyek dengan tanggal future tidak ditampilkan meskipun anda menyetel allow_future menjadi True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Sebuah boolean menentukan apakah mengambil daftar penuh dari obyek-obyek untuk tahun ini dan melewatkan itu ke cetakan. Jika True, daftar dari obyek-obyek akan dibuat tersedia ke konteks. Jika False, queryset None akan digunakan sebagai daftar obyek. Secara awalan, ini adalah False.
Menentukan jika sebuah daftar obyek akan dikembalikan sebagai bagian dari konteks. Mengembalikan make_object_list secara awalan.
Konteks
\nSebagai tambahan pada konteks disediakan oleh django.views.generic.list.MultipleObjectMixin (melalui django.views.generic.dates.BaseDateListView), konteks cetakan akan menjadi:
date_list: Sebuah obyek QuerySet mengandung semua bulan yang mempunyai obyek-obyek tersedia menurut pada queryset, diwakili sebagai obyek datetime.datetime, dalam urutan menaik.
year: Sebuah obyek date mewakili tahun yang diberikan.
next_year: Sebuah obyek date mewakili hari pertama dari tahun selanjutnya menurut allow_empty dan allow_future.
previous_year: Sebuah obyek date mewakili hari pertama dari tahun sebelumnya, menurut allow_empty dan allow_future.
Catatan
\nMenggunakan template_name_suffix awal dari _archive_year.
Contoh myapp/views.py:
\nfrom 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\nContoh myapp/urls.py:
\nfrom django.urls import path\n\nfrom myapp.views import ArticleYearArchiveView\n\nurlpatterns = [\n path("<int:year>/", ArticleYearArchiveView.as_view(), name="article_year_archive"),\n]\nContoh myapp/article_archive_year.html:
\n<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>\nMonthArchiveViewLink to this heading#Halaman arsip tahunan menampilkan semua obyek di tahun yang diberikan. Obyek-obyek dengan tanggal future tidak ditampilkan meskipun anda menyetel allow_future menjadi True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Konteks
\nSebagai tambahan pada konteks disediakan oleh MultipleObjectMixin (melalui django.views.generic.dates.BaseDateListView), konteks cetakan akan menjadi:
date_list: Sebuah obyek QuerySet mengandung semua hari yang mempunyai obyek-obyek tersedia di bulan yang diberikan, menurut pada queryset, diwakili sebagai obyek datetime.datetime, dalam urutan menaik.
month: Sebuah obyek date mewakili bulanyang diberikan.
next_month: Sebuah obyek date mewakili hari pertama dari bulan selanjutnya menurut allow_empty dan allow_future.
previous_month: Sebuah obyek date mewakili hari pertama dari bulan sebelumnya, menurut allow_empty dan allow_future.
Catatan
\nMenggunakan template_name_suffix awal dari _archive_month.
Contoh myapp/views.py:
\nfrom 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\nContoh myapp/urls.py:
\nfrom 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]\nContoh myapp/article_archive_month.html:
\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_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>\nWeekArchiveViewLink to this heading#Halaman arsip tahunan menampilkan semua obyek di minggu yang diberikan. Obyek-obyek dengan tanggal future tidak ditampilkan meskipun anda menyetel allow_future menjadi True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Konteks
\nSebagai tambahan pada konteks disediakan oleh MultipleObjectMixin (melalui django.views.generic.dates.BaseDateListView), konteks cetakan akan menjadi:
week: Sebuah obyek date mewakili hari pertama dari minggu yang diberikan.
next_week: Sebuah obyek date mewakili hari pertama dari minggu selanjutnya menurut allow_empty dan allow_future.
previous_week: Sebuah obyek date mewakili hari pertama dari minggu sebelumnya, menurut allow_empty dan allow_future.
Catatan
\nMenggunakan template_name_suffix awal dari _archive_week.
Atribut week_format adalah sebuah bentuk string strptime() digunakan untuk mengurai nomor minggu. Nilai-nilai berikut adalah didukung:
'%U': Berdasarkan pada sistem minggu Amerika Serikat dimana minggu dimulai pada hari Minggu. Ini adalah nilai awalan.
'%W': Mirip pada '%U', kecuali itu menganggap bahwa minggu dimulai pada hari Senin. Ini tidak sama seperti nomor minggu ISO 8601.
'%V': ISO 8601 week number where the week begins on Monday.
Contoh myapp/views.py:
\nfrom 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\nContoh myapp/urls.py:
\nfrom 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]\nContoh myapp/article_archive_week.html:
\n<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>\nDi contoh ini, anda mengeluarkan nomor minggu. Harap diingat bahwa nomor minggu dihitung oleh penyaring cetakan date dengan karakter bentuk 'W' tidak selalu sama ketika itu dihitung oleh strftime() dan strptime() dengan string bentuk strptime(). untuk tahun 2015, sebagai keluaran contoh nomor minggu oleh date adalah lebih tinggi oleh satu dibandingkan ke keluarannya oleh strftime(). Tidak ada setara untuk string bentuk '%U'` strftime() di date. Karena itu, anda harus menghindari menggunakan date untuk membangkitkan URL untuk WeekArchiveView.
DayArchiveViewLink to this heading#Halaman arsip tahunan menampilkan semua obyek di hari yang diberikan. Hari-hari d masa depan melemparkan sebuah kesalahan 404, terlepas dari apapun setiap obyek ada untuk hari akan datang, meskipun anda menyetel allow_future menjadi True.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Konteks
\nSebagai tambahan pada konteks disediakan oleh MultipleObjectMixin (melalui django.views.generic.dates.BaseDateListView), konteks cetakan akan menjadi:
day: Sebuah obyek date mewakili hari diberikan.
next_day: Sebuah obyek date mewakili hari selanjutnya, menurut allow_empty dan allow_future.
previous_day: Sebuah obyek date mewakili hari sebelumnya, menurut allow_empty dan allow_future.
next_month: Sebuah obyek date mewakili hari pertama dari bulan selanjutnya menurut allow_empty dan allow_future.
previous_month: Sebuah obyek date mewakili hari pertama dari bulan sebelumnya, menurut allow_empty dan allow_future.
Catatan
\nMenggunakan template_name_suffix awal dari _archive_day.
Contoh myapp/views.py:
\nfrom 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\nContoh myapp/urls.py:
\nfrom 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]\nContoh myapp/article_archive_day.html:
\n<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>\nTodayArchiveViewLink to this heading#Halaman arsip hari menampilkan semua obyek untuk today. Ini sebenarnya sama seperti django.views.generic.dates.DayArchiveView, kecuali tanggal hari ini digunakan daripada argumen year/month/day.
Ancestors (MRO)
\ndjango.views.generic.list.MultipleObjectTemplateResponseMixin
Catatan
\nMenggunakan template_name_suffix awal dari _archive_today.
Contoh myapp/views.py:
\nfrom 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\nContoh myapp/urls.py:
\nfrom django.urls import path\n\nfrom myapp.views import ArticleTodayArchiveView\n\nurlpatterns = [\n path("today/", ArticleTodayArchiveView.as_view(), name="archive_today"),\n]\nDateDetailViewLink to this heading#Sebuah halaman mewakili obyek perseorangan. Jika obyek mempunyai nilai tanggal di masa depan, tampilan akan melempar sebuah kesalahan 404 secara awalan, meskipun anda menyetel allow_future menjadi True.
Ancestors (MRO)
\ndjango.views.generic.detail.SingleObjectTemplateResponseMixin
Konteks
\nDisertakan obyek tunggal terkait dengan model ditentukan di DateDetailView.
Catatan
\nMenggunakan template_name_suffix awal dari _detail.
Contoh myapp/urls.py:
\nfrom 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]\nContoh myapp/article_detail.html:
\n<h1>{{ object.title }}</h1>\n