Added date based filtering

docs/date_based_filtering.rst

@@ -1,2 +1,16 @@
 How to add date base filtering in Django admin?
 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
+You can add a date based filtering on any date field by setting the :code:`date_hierarchy`.::
+
+    @admin.register(Hero)
+    class HeroAdmin(admin.ModelAdmin, ExportCsvMixin):
+        ...
+        date_hierarchy = 'added_on'
+
+
+It looks like this:
+
+.. image:: date_filtering.png
+
+This can be very costly with a large number of objects. As an alternative, you can subclass :code:`SimpleListFilter`, and allow filtering only on years or the months.

heroes_and_monsters/entities/admin.py

@@ -54,6 +54,7 @@ class HeroAdmin(admin.ModelAdmin, ExportCsvMixin):
     list_display = ("name", "is_immortal", "category", "origin", "is_very_benevolent", "children_display")
     list_filter = ("is_immortal", "category", "origin", IsVeryBenevolentFilter)
     actions = ["mark_immortal"]
+    date_hierarchy = 'added_on'
 
     exclude = ['added_by',]