# Dokumentasi Django 5.2.8

# 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

  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:

    - 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)

    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`

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

    - 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)

    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`

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

    - 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)

    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`

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

  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:

    - 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)

    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

  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`

class 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

  - `DateMixin`

  - `MultipleObjectMixin`

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