7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering This file is part of systemd.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering Copyright 2010 Lennart Poettering
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering systemd is free software; you can redistribute it and/or modify it
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering under the terms of the GNU Lesser General Public License as published by
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering the Free Software Foundation; either version 2.1 of the License, or
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering (at your option) any later version.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering systemd is distributed in the hope that it will be useful, but
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering WITHOUT ANY WARRANTY; without even the implied warranty of
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering Lesser General Public License for more details.
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering You should have received a copy of the GNU Lesser General Public License
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering along with systemd; If not, see <http://www.gnu.org/licenses/>.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <productname>systemd</productname>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <email>lennart@poettering.net</email>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refentrytitle>systemd.time</refentrytitle>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <refpurpose>Time and date specifications</refpurpose>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>In systemd, timestamps, time spans, and calendar events are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek displayed and may be specified in closely related syntaxes.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Displaying Time Spans</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Time spans refer to time durations. On display, systemd will
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek present time spans as a space-separated series of time values each
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek suffixed by a time unit.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>2h 30min</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>All specified time values are meant to be added up. The
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek above hence refers to 150 minutes.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Parsing Time Spans</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>When parsing, systemd will accept the same time span syntax.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Separating spaces may be omitted. The following time units are
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek understood:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>usec, us</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>msec, ms</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>seconds, second, sec, s</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>minutes, minute, min, m</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>hours, hour, hr, h</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>days, day, d</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <listitem><para>weeks, week, w</para></listitem>
7236f0c6d76d9646275adb7eba8b09003182d873Lennart Poettering <listitem><para>months, month, M (defined as 30.44 days)</para></listitem>
7236f0c6d76d9646275adb7eba8b09003182d873Lennart Poettering <listitem><para>years, year, y (define as 365.25 days)</para></listitem>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>If no time unit is specified, generally seconds are assumed,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek but some exceptions exist and are marked as such. In a few cases
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>ns</literal>, <literal>nsec</literal> is accepted too,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek where the granularity of the time span allows for this.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Examples for valid time span specifications:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>2 h
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering300ms20s 5day</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Displaying Timestamps</title>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Timestamps refer to specific, unique points in time. On
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek display, systemd will format these in the local timezone as
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>Fri 2012-11-23 23:02:15 CET</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The weekday is printed according to the locale choice of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <title>Parsing Timestamps</title>
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <para>When parsing, systemd will accept a similar syntax, but
b4ae407d3ed6701df4e079d65b8fc3607437c569Hristo Venev expects no timezone specification, unless it is given as the
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt literal string "UTC". In this case, the time is considered in UTC,
b4ae407d3ed6701df4e079d65b8fc3607437c569Hristo Venev otherwise in the local timezone. The weekday specification is
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt optional, but when the weekday is specified, it must either be in
b4ae407d3ed6701df4e079d65b8fc3607437c569Hristo Venev the abbreviated (<literal>Wed</literal>) or non-abbreviated
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek (<literal>Wednesday</literal>) English language form (case does
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek not matter), and is not subject to the locale choice of the user.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek Either the date, or the time part may be omitted, in which case
853382da70f69c115170f2e44273d81f876d2a66Andrew Eikum the current date or 00:00:00, respectively, is assumed. The seconds
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek component of the time may also be omitted, in which case ":00" is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek assumed. Year numbers may be specified in full or may be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek abbreviated (omitting the century).</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>A timestamp is considered invalid if a weekday is specified
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek and the date does not actually match the specified day of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>When parsing, systemd will also accept a few special
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek placeholders instead of timestamps: <literal>now</literal> may be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek used to refer to the current time (or of the invocation of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek command that is currently executed). <literal>today</literal>,
a8eaaee72a2f06e0fb64fb71de3b71ecba31dafbJan Engelhardt <literal>yesterday</literal>, and <literal>tomorrow</literal> refer to
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt 00:00:00 of the current day, the day before, or the next day,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek respectively.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>When parsing, systemd will also accept relative time
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek specifications. A time span (see above) that is prefixed with
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>+</literal> is evaluated to the current time plus the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek specified time span. Correspondingly, a time span that is prefixed
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek with <literal>-</literal> is evaluated to the current time minus
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the specified time span. Instead of prefixing the time span with
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>+</literal> or <literal>-</literal>, it may also be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek suffixed with a space and the word <literal>left</literal> or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Finally, a timespan prefixed with <literal>@</literal> is
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek evaluated relative to the UNIX time epoch 1st Jan, 1970,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Examples for valid timestamps and their normalized form
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev (assuming the current time was 2012-11-23 18:15:22 and the timezone
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev was UTC+8, for example TZ=Asia/Shanghai):</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>Fri 2012-11-23 11:12:13 → Fri 2012-11-23 11:12:13
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering 2012-11-23 11:12:13 → Fri 2012-11-23 11:12:13
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev2012-11-23 11:12:13 UTC → Fri 2012-11-23 19:12:13
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 2012-11-23 → Fri 2012-11-23 00:00:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 12-11-23 → Fri 2012-11-23 00:00:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 11:12:13 → Fri 2012-11-23 11:12:13
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 11:12:13.9900009 → Fri 2012-11-23 11:12:13
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev format_timestamp_us: Fri 2012-11-23 11:12:13.990000
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 11:12 → Fri 2012-11-23 11:12:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev now → Fri 2012-11-23 18:15:22
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev today → Fri 2012-11-23 00:00:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev today UTC → Fri 2012-11-23 16:00:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev yesterday → Fri 2012-11-22 00:00:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev tomorrow → Fri 2012-11-24 00:00:00
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev +3h30min → Fri 2012-11-23 21:45:22
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev +3h30min UTC → -EINVAL
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev -5s → Fri 2012-11-23 18:15:17
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 11min ago → Fri 2012-11-23 18:04:22
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev 11min ago UTC → -EINVAL
d08a6b02b520f64a1a3b9285d4df9892e52abcd4Hristo Venev @1395716396 → Tue 2014-03-25 03:59:56</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Note that timestamps printed by systemd will not be parsed
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek correctly by systemd, as the timezone specification is not
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek accepted, and printing timestamps is subject to locale settings
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt for the weekday, while parsing only accepts English weekday
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>In some cases, systemd will display a relative timestamp
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek (relative to the current time, or the time of invocation of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek command) instead or in addition to an absolute timestamp as
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek described above. A relative timestamp is formatted as
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>2 months 5 days ago</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Note that any relative timestamp will also parse correctly
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek where a timestamp is expected. (see above)</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Calendar events may be used to refer to one or more points
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek in time in a single expression. They form a superset of the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek absolute timestamps explained above:</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <programlisting>Thu,Fri 2012-*-1,5 11:12:13</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The above refers to 11:12:13 of the first or fifth day of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek any month of the year 2012, but only if that day is a Thursday or
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The weekday specification is optional. If specified, it
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek should consist of one or more English language weekday names,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek either in the abbreviated (Wed) or non-abbreviated (Wednesday)
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek form (case does not matter), separated by commas. Specifying two
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek weekdays separated by <literal>-</literal> refers to a range of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek continuous weekdays. <literal>,</literal> and <literal>-</literal>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek may be combined freely.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>In the date and time specifications, any component may be
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek specified as <literal>*</literal> in which case any value will
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek match. Alternatively, each component can be specified as a list of
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek values separated by commas. Values may also be suffixed with
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>/</literal> and a repetition value, which indicates that
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek the value and all values plus multiples of the repetition value
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek are matched.</para>
ab15dfb7b1bfc1b4f2ad85aa93e66aeb84a5116cHristo Venev <para>The seconds component may contain decimal fractions both in
ab15dfb7b1bfc1b4f2ad85aa93e66aeb84a5116cHristo Venev the value and the repetition. All fractions are rounded to 6
ab15dfb7b1bfc1b4f2ad85aa93e66aeb84a5116cHristo Venev decimal places.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Either time or date specification may be omitted, in which
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek case the current day and 00:00:00 is implied, respectively. If the
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek second component is not specified, <literal>:00</literal> is
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev <para>A timezone specification is not expected, unless it is given
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev as the literal string "UTC", similarly to timestamps.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>The special expressions
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>hourly</literal>, <literal>daily</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>monthly</literal>, <literal>weekly</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>semiannually</literal> may be used as
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek calendar events which refer to
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>*-*-* *:*:00</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>*-*-* *:00:00</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>*-*-* 00:00:00</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>*-*-01 00:00:00</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>Mon *-*-* 00:00:00</literal>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <literal>*-01-01 00:00:00</literal>,
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev <literal>*-01,04,07,10-01 00:00:00</literal> and
b938cb902c3b5bca807a94b277672c64d6767886Jan Engelhardt <literal>*-01,07-01 00:00:00</literal>, respectively.
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Examples for valid timestamps and their
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek normalized form:</para>
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering<programlisting> Sat,Thu,Mon-Wed,Sat-Sun → Mon-Thu,Sat,Sun *-*-* 00:00:00
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering Mon,Sun 12-*-* 2,1:23 → Mon,Sun 2012-*-* 01,02:23:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev Wed *-1 → Wed *-*-01 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev Wed-Wed,Wed *-1 → Wed *-*-01 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev Wed, 17:48 → Wed *-*-* 17:48:00
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart PoetteringWed-Sat,Tue 12-10-15 1:2:3 → Tue-Sat 2012-10-15 01:02:03
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev *-*-7 0:0:0 → *-*-07 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 10-15 → *-10-15 00:00:00
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering monday *-12-* 17:00 → Mon *-12-* 17:00:00
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering Mon,Fri *-*-3,1,2 *:30:45 → Mon,Fri *-*-01,02,03 *:30:45
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering 12,14,13,12:20,10,30 → *-*-* 12,13,14:10,20,30:00
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering mon,fri *-1/2-1,3 *:30:45 → Mon,Fri *-01/2-01,03 *:30:45
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 03-05 08:05:40 → *-03-05 08:05:40
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 08:05:40 → *-*-* 08:05:40
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 05:40 → *-*-* 05:40:00
7a529f63e60dfdccc23d61808c20ba40d9901e47Lennart Poettering Sat,Sun 12-05 08:05:40 → Sat,Sun *-12-05 08:05:40
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev Sat,Sun 08:05:40 → Sat,Sun *-*-* 08:05:40
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 2003-03-05 05:40 → 2003-03-05 05:40:00
ab15dfb7b1bfc1b4f2ad85aa93e66aeb84a5116cHristo Venev05:40:23.4200004/3.1700005 → 05:40:23.420000/3.170001
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 2003-03-05 05:40 UTC → 2003-03-05 05:40:00 UTC
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 2003-03-05 → 2003-03-05 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev 03-05 → *-03-05 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev hourly → *-*-* *:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev daily → *-*-* 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev daily UTC → *-*-* 00:00:00 UTC
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev monthly → *-*-01 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev weekly → Mon *-*-* 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev yearly → *-01-01 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev annually → *-01-01 00:00:00
2e50eb552a13c6c59c38ab400165522d39e6236aHristo Venev *:2/3 → *-*-* *:02/3:00</programlisting>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <para>Calendar events are used by timer units, see
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.timer</refentrytitle><manvolnum>5</manvolnum></citerefentry>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek for details.</para>
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>journalctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.timer</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
798d3a524ea57aaf40cb53858aaa45ec702f012dZbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>