id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
27306	Document relation between auto_now/auto_now_add and timezones	Baptiste Mispelon	nobody	"The documentation for `DateField.auto_now` states: ""Automatically set the field to now every time the object is saved."" [1]

It achieves this by doing `value = datetime.date.today()`. However, as noted in the discussion on #27082 and #25181 this might not exactly be ""now"" (depending on what you think ""now"" means).

I think the documentation should clarify how `auto_now` interracts with timezone settings, and in particular what we mean when we say ""now"". I also think there's a bug lurking in the usage of `datetime.date.today()` and we should use the new `timezone.localdate()` instead.

[1] https://docs.djangoproject.com/en/1.10/ref/models/fields/#django.db.models.DateField.auto_now"	Cleanup/optimization	closed	Documentation	1.10	Normal	invalid			Unreviewed	0	0	0	0	0	0