@@ -805,28 +805,28 @@ include::pretty-options.txt[]
805
805
author's). If `-local` is appended to the format (e.g.,
806
806
`iso-local`), the user's local time zone is used instead.
807
807
+
808
+ --
808
809
`--date=relative` shows dates relative to the current time,
809
810
e.g. ``2 hours ago''. The `-local` option has no effect for
810
811
`--date=relative`.
811
- +
812
+
812
813
`--date=local` is an alias for `--date=default-local`.
813
- +
814
+
814
815
`--date=iso` (or `--date=iso8601`) shows timestamps in a ISO 8601-like format.
815
816
The differences to the strict ISO 8601 format are:
816
817
817
818
- a space instead of the `T` date/time delimiter
818
819
- a space between time and time zone
819
820
- no colon between hours and minutes of the time zone
820
821
821
- +
822
822
`--date=iso-strict` (or `--date=iso8601-strict`) shows timestamps in strict
823
823
ISO 8601 format.
824
- +
824
+
825
825
`--date=rfc` (or `--date=rfc2822`) shows timestamps in RFC 2822
826
826
format, often found in email messages.
827
- +
827
+
828
828
`--date=short` shows only the date, but not the time, in `YYYY-MM-DD` format.
829
- +
829
+
830
830
`--date=raw` shows the date as seconds since the epoch (1970-01-01
831
831
00:00:00 UTC), followed by a space, and then the timezone as an offset
832
832
from UTC (a `+` or `-` with four digits; the first two are hours, and
@@ -835,28 +835,28 @@ with `strftime("%s %z")`).
835
835
Note that the `-local` option does not affect the seconds-since-epoch
836
836
value (which is always measured in UTC), but does switch the accompanying
837
837
timezone value.
838
- +
838
+
839
839
`--date=human` shows the timezone if the timezone does not match the
840
840
current time-zone, and doesn't print the whole date if that matches
841
841
(ie skip printing year for dates that are "this year", but also skip
842
842
the whole date itself if it's in the last few days and we can just say
843
843
what weekday it was). For older dates the hour and minute is also
844
844
omitted.
845
- +
845
+
846
846
`--date=unix` shows the date as a Unix epoch timestamp (seconds since
847
847
1970). As with `--raw`, this is always in UTC and therefore `-local`
848
848
has no effect.
849
- +
849
+
850
850
`--date=format:...` feeds the format `...` to your system `strftime`,
851
851
except for %z and %Z, which are handled internally.
852
852
Use `--date=format:%c` to show the date in your system locale's
853
853
preferred format. See the `strftime` manual for a complete list of
854
854
format placeholders. When using `-local`, the correct syntax is
855
855
`--date=format-local:...`.
856
- +
856
+
857
857
`--date=default` is the default format, and is similar to
858
858
`--date=rfc2822`, with a few exceptions:
859
-
859
+ --
860
860
- there is no comma after the day-of-week
861
861
862
862
- the time zone is omitted when the local time zone is used
0 commit comments