diff options
author | Lennart Poettering <lennart@poettering.net> | 2014-03-25 04:08:16 +0100 |
---|---|---|
committer | Lennart Poettering <lennart@poettering.net> | 2014-03-25 04:08:16 +0100 |
commit | 5ba6e0949cef1a5b947dd59665bad1ca5066619d (patch) | |
tree | 8ebd76a03be18a8c45640e8b66e4e01fdf57d021 /man | |
parent | a2b135e3d8d5dfa103a87e304ed8a91b01fdbb02 (diff) |
time: support @ syntax for denoting times since the UNIX epoch 1970-1-1
Diffstat (limited to 'man')
-rw-r--r-- | man/systemd.time.xml | 16 |
1 files changed, 11 insertions, 5 deletions
diff --git a/man/systemd.time.xml b/man/systemd.time.xml index a837f232c3..0706cdf54a 100644 --- a/man/systemd.time.xml +++ b/man/systemd.time.xml @@ -153,14 +153,19 @@ <para>When parsing, systemd will also accept relative time specifications. A time span (see above) that is prefixed with <literal>+</literal> is evaluated to the - current time plus the specified - time span. Correspondingly, a time span that is prefixed + current time plus the specified time + span. Correspondingly, a time span that is prefixed with <literal>-</literal> is evaluated to the current time minus the specified time span. Instead of - prefixing the time span with <literal>-</literal>, it - may also be suffixed with a space and the word + prefixing the time span with <literal>+</literal> or + <literal>-</literal>, it may also be suffixed with a + space and the word <literal>left</literal> or <literal>ago</literal>.</para> + <para>Finally, a timespan prefixed with + <literal>@</literal> is evaluated relative to the UNIX + time epoch 1st Jan, 1970, 00:00.</para> + <para>Examples for valid timestamps and their normalized form (assuming the current time was 2012-11-23 18:15:22):</para> @@ -177,7 +182,8 @@ tomorrow → Fri 2012-11-24 00:00:00 +3h30min → Fri 2012-11-23 21:45:22 -5s → Fri 2012-11-23 18:15:17 - 11min ago → Fri 2012-11-23 18:04:22</programlisting> + 11min ago → Fri 2012-11-23 18:04:22 + @1395716396 → Tue 2014-03-25 03:59:56</programlisting> <para>Note that timestamps printed by systemd will not be parsed correctly by systemd, as the timezone |