summaryrefslogtreecommitdiff
path: root/man/systemd.time.xml
diff options
context:
space:
mode:
authorLennart Poettering <lennart@poettering.net>2014-03-25 04:08:16 +0100
committerLennart Poettering <lennart@poettering.net>2014-03-25 04:08:16 +0100
commit5ba6e0949cef1a5b947dd59665bad1ca5066619d (patch)
tree8ebd76a03be18a8c45640e8b66e4e01fdf57d021 /man/systemd.time.xml
parenta2b135e3d8d5dfa103a87e304ed8a91b01fdbb02 (diff)
time: support @ syntax for denoting times since the UNIX epoch 1970-1-1
Diffstat (limited to 'man/systemd.time.xml')
-rw-r--r--man/systemd.time.xml16
1 files changed, 11 insertions, 5 deletions
diff --git a/man/systemd.time.xml b/man/systemd.time.xml
index a837f232c..0706cdf54 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