Nota
Todos los atributos de formato de fecha utilizados en estas mixins utilizan caracteres de formato de la función strftime(). No intentes utilizar los caracteres de formato de la etiqueta de plantilla now como no son compatibles.
YearMixin¶Una mixin que se puede usar para recuperar y proporcionar información de análisis para un componente de año de una fecha.
Métodos y Atributos
El formato strftime() a utilizar cuando se analiza el año. Por defecto, este es '%Y'.
Opcional El valor para el año, como una cadena de texto. Por defecto, establecido en None, lo que significa que el año se determinará utilizando otros medios.
Devuelve el strftime() formato a utilizar cuando se analiza el año. Devuelve por defecto year_format.
Returns el año para el que esta vista mostrará datos, como una cadena de texto. Intenta las siguientes fuentes en orden:
El valor del atributo YearMixin.year.
El valor del argumento year capturado en la expresión regular de la URL.
El valor del argumento year de consulta GET.
Lanza un 404 si no se encuentra una especificación válida de año.
Devuelve un objeto fecha que contiene el primer día del año después de la fecha proporcionada. Esta función también puede devolver None o lanzar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
Devuelve un objeto fecha que contiene el primer día del año antes de la fecha proporcionada. Esta función también puede devolver None o lanzar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
MonthMixin¶Un mixin que se puede utilizar para recuperar y proporcionar información de análisis para un componente de mes de una fecha.
Métodos y Atributos
El formato de la función strftime() a usar al analizar el mes. Por defecto, este es '%b'.
Opcional El valor para el mes, como una cadena. Por defecto, se establece en None, lo que significa que el mes se determinará mediante otros medios.
Devuelve el formato de fecha a utilizar al parsear el mes. Devuelve por defecto month_format.
Devuelve el mes para el que esta vista mostrará los datos, como una cadena. Intenta las siguientes fuentes, en orden:
El valor del atributo MonthMixin.month.
El valor del argumento month capturado en la expresión regular de URL.
El valor del argumento month de consulta GET.
Lanza un 404 si no se puede encontrar ninguna especificación válida de mes.
Devuelve un objeto fecha que contiene el primer día del mes después de la fecha proporcionada. Esta función también puede devolver None o lanzar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
Devuelve un objeto fecha que contiene el primer día del mes antes de la fecha proporcionada. Esta función también puede devolver None o lanzar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
DayMixin¶Un mixin que se puede utilizar para recuperar y proporcionar información de análisis para un componente de día de una fecha.
Métodos y Atributos
El formato de la función strftime() a usar al analizar el día. Por defecto, este es '%d'.
Opcional El valor del día, como cadena de texto. Por defecto, se establece en None, lo que significa que el día se determinará utilizando otros medios.
Devuelve el formato de la función strftime() a usar al analizar el día. Devuelve por defecto day_format.
Devuelve el día para el cual esta vista mostrará datos, como cadena de texto. Intenta las siguientes fuentes, en orden:
El valor del atributo DayMixin.day.
El valor del argumento day capturado en la expresión regular de la URL.
El valor del argumento day de consulta GET.
Lanza un 404 si no se puede encontrar una especificación válida para el día.
Devuelve un objeto fecha que contiene el siguiente día válido después de la fecha proporcionada. Esta función también puede devolver None o lanzar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
Returns un objeto de fecha que contiene el día válido anterior. Esta función también puede devolver None o lanzar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
WeekMixin¶Un mixin que se puede utilizar para obtener e informar la información de parsing para un componente semanal de una fecha.
Métodos y Atributos
El formato a usar con strftime() al parsear la semana. Por defecto, este es '%U', lo que significa que la semana comienza el domingo. Establezcalo en '%W' o '%V' (ISO 8601 week) si tu semana comienza el lunes.
Opcional El valor de la semana, como una cadena de texto. Por defecto, establecido a None, lo que significa que la semana se determinará utilizando otros medios.
Devuelve el formato a usar con strftime() al parsear la semana. Devuelve por defecto week_format.
Devuelve la semana para la cual este vista mostrará datos, como una cadena de texto. Intenta las siguientes fuentes, en orden:
El valor del atributo WeekMixin.week.
El valor del argumento week capturado en el patrón de URL.
El valor del argumento week de consulta GET.
Raises a 404 si no se encuentra una especificación de semana válida.
Devuelve un objeto fecha que contiene el primer día de la semana después de la fecha proporcionada. Esta función también puede devolver None o levantar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
Devuelve un objeto fecha que contiene el primer día de la semana antes de la fecha proporcionada. Esta función también puede devolver None o levantar una excepción Http404, dependiendo de los valores de allow_empty y allow_future.
DateMixin¶Una clase mixin que proporciona comportamiento común para todas las vistas basadas en fecha.
Métodos y Atributos
El nombre del campo DateField o DateTimeField en el conjunto de resultados de la consulta que la vista de archivo por fecha debe utilizar para determinar la lista de objetos a mostrar en la página.
Cuando se habilita el soporte de zona horaria y date_field es un campo DateTimeField, las fechas se asumen que están en la zona horaria actual. De lo contrario, el conjunto de resultados podría incluir objetos del día anterior o del día siguiente en la zona horaria del usuario final.
Advertencia
En esta situación, si has implementado la selección de zona horaria por usuario, la misma URL puede mostrar un conjunto diferente de objetos, dependiendo de la zona horaria del usuario final. Para evitar esto, debes utilizar un campo DateField como atributo date_field.
Un booleano que especifica si se deben incluir los «objetos futuros» en esta página, donde «futuro» significa objetos en los cuales el campo especificado en date_field es mayor que la fecha/hora actual. Por defecto, esto es False.
Devuelve el nombre del campo que contiene los datos de fecha con los que esta vista operará. Devuelve date_field por defecto.
Determine si incluir objetos «futuros» en esta página, donde «futuro» significa objetos en los que el campo especificado en date_field es mayor que la fecha/hora actual. Devuelve allow_future por defecto.
BaseDateListView¶Una clase base que proporciona comportamiento común para todas las vistas basadas en fechas. Normalmente no habrá una razón para instanciar BaseDateListView; instancia en su lugar una de sus subclases.
Mientras esta vista (y sus subclases) estén ejecutándose, self.object_list contendrá la lista de objetos que la vista está operando y self.date_list contendrá la lista de fechas para las cuales hay datos disponibles.
Mixins
Métodos y Atributos
Un booleano que especifica si mostrar la página si no hay objetos disponibles. Si este es True y no hay objetos disponibles, la vista mostrará una página vacía en lugar de levantar un 404.
Esto es idéntico a django.views.generic.list.MultipleObjectMixin.allow_empty, excepto por el valor por defecto, que es False.
Opcional Una cadena que define el período de agregación para date_list. Debe ser uno de 'year' (por defecto), 'month', o 'day'.
Returns a 3-tuple conteniendo (date_list, object_list, extra_context).
date_list es la lista de fechas para las cuales está disponible los datos. object_list es la lista de objetos. extra_context es un diccionario de datos de contexto que se agregarán a cualquier dato de contexto proporcionado por el MultipleObjectMixin.
Returns una consulta, filtrada utilizando los argumentos de consulta definidos por lookup. Aplica cualquier restricción en la consulta, como allow_empty y allow_future.
Returns el período de agregación para date_list. Returns date_list_period por defecto.
Returns la lista de fechas del tipo date_type para las cuales queryset contiene entradas. Por ejemplo, get_date_list(qs, 'year') devolverá la lista de años para los cuales qs tiene entradas. Si no se proporciona date_type, el resultado de get_date_list_period() se utiliza. date_type y ordering se pasan a QuerySet.dates().
may 31, 2026