# Dokumentasi Django 4.2.9.dev20231204082947

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