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
[sumber]¶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
()[sumber]¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai tahun. Mengembalikan year_format
secara awalan.
get_year
()[sumber]¶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)[sumber]¶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)[sumber]¶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
[sumber]¶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
()[sumber]¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai bulan. Mengembalikan month_format
secara awalan.
get_month
()[sumber]¶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)[sumber]¶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)[sumber]¶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
[sumber]¶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
()[sumber]¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai hari. Mengembalikan day_format
secara awalan.
get_day
()[sumber]¶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)[sumber]¶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)[sumber]¶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
[sumber]¶Sebuah mixin yang dapat digunakan mengambil dan menyediakan informasi mengurai untuk komponen minggu dari tanggal.
Cara dan Atribut
week_format
¶Bentuk strftime()
digunakan ketika mengurai minggu. Secara awal, ini adalah '%U'
, yang berarti minggu mulai pada hari Minggu. Setel itu menjadi '%W'
jika minggu anda mulai pada hari Senin.
week
¶Pilihan Nilai dari minggu, sebagai deretan kalimat. Secara awal, disetel ke``None``, yang berarti minggu akan ditentukan menggunakan cara lain.
get_week_format
()[sumber]¶Mengembalikan bentuk strftime()
untuk digunakan ketika mengurai minggu. Mengembalikan week_format
secara awalan.
get_week
()[sumber]¶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)[sumber]¶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
[sumber]¶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
()[sumber]¶Mengembalikan nama dari bidang yang mengandung data tanggal yang tampilan ini akan berjalan. Mengembalikan date_field
secara awalan.
get_allow_future
()[sumber]¶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
[sumber]¶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
()[sumber]¶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)[sumber]¶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
()[sumber]¶Mengembalikan masa pengumpulan untuk date_list
. Mengembalikan date_list_period
secara awalan.
get_date_list
(queryset, date_type=None, ordering='ASC')[sumber]¶Mengembalikan daftar dari tanggal dari jenis date_type
yang queryset
mengandung masukan. Sebagai contoh, get_date_list(qs, 'year')
akan mengembalikan daftar tahun yang qs
telah masukkan. Jika date_type
tidak disediakan, hasil dari get_date_list_period()
digunakan. date_type
dan ordering
cukup dilewatkan ke QuerySet.dates()
.
Des 02, 2017