Mixin berdasarkan-tanggal

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

class 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:

  • Nilai dari atribut YearMixin.year.
  • Nilai dari argumen year ditangkap di corak URL.
  • Nilai dari argumen permintaan 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

class 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:

  • Nilai dari atribut MonthMixin.month.
  • Nilai dari argumen month ditangkap di corak URL.
  • Nilai dari argumen permintaan 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

class 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:

  • Nilai dari atribut DayMixin.day.
  • Nilai dari argumen day ditangkap di corak URL.
  • Nilai dari argumen permintaan 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

class 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:

  • Nilai dari atribut WeekMixin.week.
  • Nilai dari argumen week ditangkap di corak URL.
  • Nilai dari argumen permintaan 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

class 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

class 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().