Catatan
Semua atribut pembentukan tanggal di mixin ini menggunakan karakter bentuk strftime()
. Jangan mencoba menggunakan karakter bentuk dari etiket cetakan now
karena mereka tidak cocok.
YearMixin
¶YearMixin
¶Sebuah mixin yang dapat digunakan mengambil dan menyediakan informasi mengurai untuk komponen tahun dari tanggal.
Cara dan Atribut
year_format
¶Bentuk strftime()
digunakan ketika mengurai tahun. Secara awal, ini adalah '%Y'
.
year
¶Pilihan Nilai untuk tahun, sebagai deretan kalimat. Secara awal, disetel ke None
, yang berarti tahun akan ditentukan menggunakan cara lain.
get_year_format
()¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai tahun. Mengembalikan year_format
secara awalan.
get_year
()¶Mengembalikan tahun untuk dimana tampilan ini akan menampilkan data, sebagai deretan kalimat. Coba sumber berikut, dalam urutan:
YearMixin.year
.year
ditangkap di corak URL.GET
year
.Memunculkan 404 jika spesifikasi tahun tidak sah ditemukan.
get_next_year
(date)¶Mengembalikan obyek tanggal mengandung hari pertama dari tahun setelah tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
get_previous_year
(date)¶Mengembalikan obyek tanggal mengandung hari pertama dari tahun setelah tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
MonthMixin
¶MonthMixin
¶Sebuah mixin yang dapat digunakan mengambil dan menyediakan informasi mengurai untuk komponen bulan dari tanggal.
Cara dan Atribut
month_format
¶Bentuk strftime()
untuk digunakan ketika mengurai bulan. Secara awalan, ini adalah '%b'
.
month
¶Pilihan Nilai dari bulan, sebagai deretan kalimat. Secara awal, disetel ke None
, yang berarti bulan akan ditentukan menggunakan cara lain.
get_month_format
()¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai bulan. Mengembalikan month_format
secara awalan.
get_month
()¶Mengembalikan bulan untuk dimana tampilan ini akan menampilkan data, sebagai deretan kalimat. Coba sumber berikut, dalam urutan:
MonthMixin.month
.month
ditangkap di corak URL.GET
month
.Memunculkan 404 jika spesifikasi bulan tidak sah ditemukan.
get_next_month
(date)¶Mengembalikan obyek tanggal mengandung hari pertama dari bulan setelah tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
get_previous_month
(date)¶Mengembalikan obyek tanggal mengandung hari pertama dari bulan sebelum tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
DayMixin
¶DayMixin
¶Sebuah mixin yang dapat digunakan mengambil dan menyediakan informasi mengurai untuk komponen hari dari tanggal.
Cara dan Atribut
day_format
¶Bentuk strftime()
digunakan ketika mengurai tahun. Secara awal, ini adalah '%d'
.
day
¶Pilihan Nilai dari hari, sebagai deretan kalimat. Secara awal, disetel ke``None``, yang berarti hari akan ditentukan menggunakan cara lain.
get_day_format
()¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai hari. Mengembalikan day_format
secara awalan.
get_day
()¶Mengembalikan hari untuk dimana tampilan ini akan menampilkan data, sebagai deretan kalimat. Coba sumber berikut, dalam urutan:
DayMixin.day
.day
ditangkap di corak URL.GET
day
.Memunculkan 404 jika spesifikasi hari tidak sah ditemukan.
get_next_day
(date)¶Mengembalikan obyek tanggal mengandung hari sah selanjutnya setelah tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
get_previous_day
(date)¶Mengembalikan obyek tanggal mengandung hari sah sebelumnya. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
WeekMixin
¶WeekMixin
¶Sebuah mixin yang dapat digunakan mengambil dan menyediakan informasi mengurai untuk komponen minggu dari tanggal.
Cara dan Atribut
week_format
¶The strftime()
format to use when parsing the week. By
default, this is '%U'
, which means the week starts on Sunday. Set
it to '%W'
or '%V'
(ISO 8601 week) if your week starts on
Monday.
Support for the '%V'
week format was added.
week
¶Pilihan Nilai dari minggu, sebagai deretan kalimat. Secara awal, disetel ke``None``, yang berarti minggu akan ditentukan menggunakan cara lain.
get_week_format
()¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai minggu. Mengembalikan week_format
secara awalan.
get_week
()¶Mengembalikan minggu untuk dimana tampilan ini akan menampilkan data, sebagai deretan kalimat. Coba sumber berikut, dalam urutan:
WeekMixin.week
.week
ditangkap di corak URL.GET
week
.Memunculkan 404 jika spesifikasi minggu tidak sah ditemukan.
get_next_week
(date)¶Mengembalikan obyek tanggal mengandung hari pertama dari minggu setelah tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
get_prev_week
(date)¶Mengembalikan obyek tanggal mengandung hari pertama dari minggu setelah tanggal disediakan. Fungsi ini dapat juga mengembalikan None
atau memunculkan pengecualian Http404
, tergantung pada nilai dari allow_empty
dan allow_future
.
DateMixin
¶DateMixin
¶Sebuah kelas mixin menyediakan perilaku umum untuk semua tampilan berdasarkan-tanggal.
Cara dan Atribut
date_field
¶Nama dari DateField
atau DateTimeField
di model QuerySet
yang arsip berdasarkan-tanggal harus digunakan untuk menentukan daftar dari obyek untuk diperlihatkan pada halaman.
Ketika time zone support diadakan dan date_field
adalah sebuah DateTimeField
, tanggal dianggap menjadi di zona waktu saat ini. Jika tidak, queryset dapat menyertakan obyek-obyek dari sebelum atau hari selanjutnya di akhir zona waktu pengguna.
Peringatan
Di keadaan ini, jika anda telah menerapkan pemilihan zona waktu per-pengguna, URL sama mungkin menampilkan kumpulan berbeda dari obyek-obyek, tergantung pada zona waktu pengguna akhir. Untuk menghindari ini, anda harus menggunakan DateField
sebagai atribut date_field
.
allow_future
¶Sebuah boolean menentukan apakah menyertakan obyek-obyek "future" pada halaman ini, dimana "future" berarti obyek-obyek dimana bidang ditentukan di date_field
adalah lebih besar dari tanggal/waktu saat ini. Secara awalan, ini adalah False
.
get_date_field
()¶Mengembalikan nama dari bidang yang mengandung data tanggal yang tampilan ini akan berjalan. Mengembalikan date_field
secara awalan.
get_allow_future
()¶Menentukan apakah menyertakan obyek-obyek "future" pada halaman ini, dimana "future" berarti obyek-obyek dimana bidang ditentukan di date_field
adalah lebih besar dari tanggal/waktu saat ini. Mengembalikan allow_future
secara awalan.
BaseDateListView
¶BaseDateListView
¶Sebuah kelas dasar yang menyediakan perilaku umum untuk semua tampilan berdasarkan-tanggal. Biasanya tidak akanmenjadi sebuah alasan untuk menginstasiasi BaseDateListView
; instasiasi satu dari subkelas-subkelas sebagai gantinya.
Selagi tampilan ini (dan subkelasnya) dikerjakan, self.object_list
akan mengandung daftar dari obyek-obyek yang tampilan adalah beroperasi, dan self.date_list
akan mengandung daftar dari tanggal yang data tersedia.
Mixins
Cara dan Atribut
allow_empty
¶Sebuah boolean menentukan apakah memperlihatkan halaman jika tidak ada obyek tersedia. Jika ini adalah True
dan tidak ada obyek tersedia, tampilan akan meemperlihatkan sebuah halaman kosong daripada memunculkan sebuah 404.
Ini mirip pada django.views.generic.list.MultipleObjectMixin.allow_empty
, kecuali untuk nilai awalan, yaitu False
.
date_list_period
¶Pilihan String menentukan masa pengumpulan untuk date_list
. Itu harus berupa satu dari 'year'
(awalan), 'month'
, atau 'day'
.
get_dated_items
()¶Mengembalikan 3-tuple mengandung (date_list
, object_list
, extra_context
).
date_list
adalah daftar tanggal yang data tersedia. object_list
adalah daftar dari obyek. extra_context
adalah sebuah kamus dari konteks data yang akan ditambahkan ke konteks data apapun disediakan oleh MultipleObjectMixin
.
get_dated_queryset
(**lookup)¶Mengembalikan sebuah queryset, disaring menggunakan argumen permintaan ditentukan oleh lookup
. Memaksa larangan apapun pada queryset, seperti allow_empty
dan allow_future
.
get_date_list_period
()¶Mengembalikan masa pengumpulan untuk date_list
. Mengembalikan date_list_period
secara awalan.
get_date_list
(queryset, date_type=None, ordering='ASC')¶Returns the list of dates of type date_type
for which queryset
contains entries. For example, get_date_list(qs, 'year')
will
return the list of years for which qs
has entries. If
date_type
isn't provided, the result of
get_date_list_period()
is used. date_type
and ordering
are passed to
QuerySet.dates()
.
Agu 03, 2022