Allow using GMT in the HTML last updated format

[AA-Turner]

Feature or Bugfix

• Feature

Purpose

Add html_last_updated_time_zone to allow using GMT (universal time) instead of local time for the date-time supplied to html_last_updated_fmt.

Detail

This is useful when html_last_updated_fmt includes hours or minutes, and when working on a project that spans time zones. For example, the Python project (at time of writing) overwrites html_last_updated_fmt with a static time as local time is unhelpful.

A

[mgeier]

Wouldn't it be more useful to be able to specify an arbitrary time zone instead of only having GMT as a choice?

This is how I did it in my sphinx_last_updated_by_git extension: https://github.com/mgeier/sphinx-last-updated-by-git/blob/7d226ef95ff2e19caaddc5018fb86f1bbf304232/src/sphinx_last_updated_by_git.py#L258-L263

Also, I'm not sure if "GMT" is the right term. Shouldn't it be "UTC"?

[AA-Turner]

Perhaps, but I'm not particularly fond of adding more options. By default I think continuing to target the local timezone is the right choice.

The option here is to use a standard time, for which GMT/UTC/Universal time seemed most appropriate. To my knowledge there haven't been any requests to configure timezones?

A