sntran / deno_at Goto Github PK

The at utility allows some moderately complex time specifications. It accepts times of the form HHMM or HH:MM to run a job at a specific time of day. (If that time is already past, the next day is assumed.)

As an alternative, the following keywords may be specified: midnight, noon, or teatime (4pm) and time-of-day may be suffixed with AM or PM for running in the morning or the evening.

The day on which the job is to be run may also be specified by giving a date in the form "month-name day" with an optional year, or giving a date of the forms DD.MM.YYYY, DD.MM.YY, MM/DD/YYYY, MM/DD/YY, MMDDYYYY, or MMDDYY. The specification of a date must follow the specification of the time of day.

Time can also be specified as: "[now] + count time-units", where the time-units can be minutes, hours, days, weeks, months or years and at may be told to run the job today by suffixing the time with today and to run the job tomorrow by suffixing the time with tomorrow. The shortcut next can be used instead of + 1.

For example, to run a job at 4pm three days from now, use at 4pm + 3 days, to run a job at 10:00am on July 31, use at 10am Jul 31 and to run a job at 1am tomorrow, use at 1am tomorrow.

The at utility also supports the POSIX time format. The argument should be in the form [[CC]YY]MMDDhhmm[.SS] where each pair of letters represents the following:

               CC      The first two digits of the year (the century).
               YY      The second two digits of the year.
               MM      The month of the year, from 1 to 12.
               DD      the day of the month, from 1 to 31.
               hh      The hour of the day, from 0 to 23.
               mm      The minute of the hour, from 0 to 59.
               SS      The second of the minute, from 0 to 61.

If the CC and YY letter pairs are not specified, the values default to the current year. If the SS letter pair is not specified, the value defaults to 0.

See parsetime.c