borgbackup/docs/usage/general/date-time.rst.inc

Date and Time
~~~~~~~~~~~~~

We format date and time in accordance with ISO 8601, that is: YYYY-MM-DD and
HH:MM:SS (24-hour clock).

For more information, see: https://xkcd.com/1179/

Unless otherwise noted, we display local date and time.
Internally, we store and process date and time as UTC.


.. rubric:: TIMESPAN

Some options accept a TIMESPAN parameter, which can be given as a number of
years (e.g. ``2y``), months (e.g. ``12m``), weeks (e.g. ``2w``),
days (e.g. ``7d``), hours (e.g. ``8H``), minutes (e.g. ``30M``),
or seconds (e.g. ``150S``).
[DOCS] #4587 – Make Sphinx warnings break docs build general.rst and man_intro.rst both included usage_general.rst.inc, which resulted in three Sphinx warning "WARNING: duplicate label". To prevent this we move all sections of usage_general into own include files and add a second usage_general file without the three labels. 2020-03-16 14:17:16 -04:00			`Date and Time`
			`~~~~~~~~~~~~~`

fixed typos and grammar (AI) this was done by Junie AI. 2025-08-23 18:21:57 -04:00			`We format date and time in accordance with ISO 8601, that is: YYYY-MM-DD and`
			`HH:MM:SS (24-hour clock).`
[DOCS] #4587 – Make Sphinx warnings break docs build general.rst and man_intro.rst both included usage_general.rst.inc, which resulted in three Sphinx warning "WARNING: duplicate label". To prevent this we move all sections of usage_general into own include files and add a second usage_general file without the three labels. 2020-03-16 14:17:16 -04:00
fixed typos and grammar (AI) this was done by Junie AI. 2025-08-23 18:21:57 -04:00			`For more information, see: https://xkcd.com/1179/`
[DOCS] #4587 – Make Sphinx warnings break docs build general.rst and man_intro.rst both included usage_general.rst.inc, which resulted in three Sphinx warning "WARNING: duplicate label". To prevent this we move all sections of usage_general into own include files and add a second usage_general file without the three labels. 2020-03-16 14:17:16 -04:00
			`Unless otherwise noted, we display local date and time.`
			`Internally, we store and process date and time as UTC.`
Add TIMESPAN to doc - Closes borgbackup/borg#8310 2024-07-30 17:49:50 -04:00

			`.. rubric:: TIMESPAN`

Allow timespan to be specified with common time units (#8626) allow timespan to be specified with common time units, fixes #8624 Co-authored-by: Ken Kundert <ken@theKunderts.net> 2025-01-08 12:48:10 -05:00			`Some options accept a TIMESPAN parameter, which can be given as a number of`
			years (e.g. ``2y``), months (e.g. ``12m``), weeks (e.g. ``2w``),
manual corrections/reverts 2025-09-04 14:29:43 -04:00			days (e.g. ``7d``), hours (e.g. ``8H``), minutes (e.g. ``30M``),
			or seconds (e.g. ``150S``).