1 /* vi: set sw=4 ts=4: */
3 * Mini date implementation for busybox
5 * by Matthew Grant <grantma@anathoth.gen.nz>
7 * iso-format handling added by Robert Griebl <griebl@gmx.de>
8 * bugfixes and cleanup by Bernhard Reutner-Fischer
10 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
13 /* This 'date' command supports only 2 time setting formats,
14 all the GNU strftime stuff (its in libc, lets use it),
15 setting time using UTC and displaying it, as well as
16 an RFC 2822 compliant date output for shell scripting
19 /* Input parsing code is always bulky - used heavy duty libc stuff as
20 much as possible, missed out a lot of bounds checking */
22 //applet:IF_DATE(APPLET(date, BB_DIR_BIN, BB_SUID_DROP))
24 //kbuild:lib-$(CONFIG_DATE) += date.o
30 //config: date is used to set the system date or display the
31 //config: current time in the given format.
33 //config:config FEATURE_DATE_ISOFMT
34 //config: bool "Enable ISO date format output (-I)"
36 //config: depends on DATE
38 //config: Enable option (-I) to output an ISO-8601 compliant
39 //config: date/time string.
41 //config:# defaults to "no": stat's nanosecond field is a bit non-portable
42 //config:config FEATURE_DATE_NANO
43 //config: bool "Support %[num]N nanosecond format specifier"
45 //config: depends on DATE # syscall(__NR_clock_gettime)
46 //config: select PLATFORM_LINUX
48 //config: Support %[num]N format specifier. Adds ~250 bytes of code.
50 //config:config FEATURE_DATE_COMPAT
51 //config: bool "Support weird 'date MMDDhhmm[[YY]YY][.ss]' format"
53 //config: depends on DATE
55 //config: System time can be set by 'date -s DATE' and simply 'date DATE',
56 //config: but formats of DATE string are different. 'date DATE' accepts
57 //config: a rather weird MMDDhhmm[[YY]YY][.ss] format with completely
58 //config: unnatural placement of year between minutes and seconds.
59 //config: date -s (and other commands like touch -d) use more sensible
60 //config: formats (for one, ISO format YYYY-MM-DD hh:mm:ss.ssssss).
62 //config: With this option off, 'date DATE' is 'date -s DATE' support
63 //config: the same format. With it on, 'date DATE' additionally supports
64 //config: MMDDhhmm[[YY]YY][.ss] format.
66 /* GNU coreutils 6.9 man page:
67 * date [OPTION]... [+FORMAT]
68 * date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]
70 * display time described by STRING, not `now'
72 * like --date once for each line of DATEFILE
73 * -r, --reference=FILE
74 * display the last modification time of FILE
76 * output date and time in RFC 2822 format.
77 * Example: Mon, 07 Aug 2006 12:34:56 -0600
79 * output date and time in RFC 3339 format.
80 * TIMESPEC='date', 'seconds', or 'ns'
81 * Date and time components are separated by a single space:
82 * 2006-08-07 12:34:56-06:00
84 * set time described by STRING
85 * -u, --utc, --universal
86 * print or set Coordinated Universal Time
89 * long options are not supported
91 * -I seems to roughly match --rfc-3339, but -I has _optional_ param
92 * (thus "-I seconds" doesn't work, only "-Iseconds"),
93 * and does not support -Ins
94 * -D FMT is a bbox extension for _input_ conversion of -d DATE
97 //usage:#define date_trivial_usage
98 //usage: "[OPTIONS] [+FMT] [TIME]"
99 //usage:#define date_full_usage "\n\n"
100 //usage: "Display time (using +FMT), or set time\n"
101 //usage: IF_NOT_LONG_OPTS(
102 //usage: "\n [-s] TIME Set time to TIME"
103 //usage: "\n -u Work in UTC (don't convert to local time)"
104 //usage: "\n -R Output RFC-2822 compliant date string"
105 //usage: ) IF_LONG_OPTS(
106 //usage: "\n [-s,--set] TIME Set time to TIME"
107 //usage: "\n -u,--utc Work in UTC (don't convert to local time)"
108 //usage: "\n -R,--rfc-2822 Output RFC-2822 compliant date string"
110 //usage: IF_FEATURE_DATE_ISOFMT(
111 //usage: "\n -I[SPEC] Output ISO-8601 compliant date string"
112 //usage: "\n SPEC='date' (default) for date only,"
113 //usage: "\n 'hours', 'minutes', or 'seconds' for date and"
114 //usage: "\n time to the indicated precision"
116 //usage: IF_NOT_LONG_OPTS(
117 //usage: "\n -r FILE Display last modification time of FILE"
118 //usage: "\n -d TIME Display TIME, not 'now'"
119 //usage: ) IF_LONG_OPTS(
120 //usage: "\n -r,--reference FILE Display last modification time of FILE"
121 //usage: "\n -d,--date TIME Display TIME, not 'now'"
123 //usage: IF_FEATURE_DATE_ISOFMT(
124 //usage: "\n -D FMT Use FMT for -d TIME conversion"
127 //usage: "\nRecognized TIME formats:"
128 //usage: "\n hh:mm[:ss]"
129 //usage: "\n [YYYY.]MM.DD-hh:mm[:ss]"
130 //usage: "\n YYYY-MM-DD hh:mm[:ss]"
131 //usage: "\n [[[[[YY]YY]MM]DD]hh]mm[.ss]"
132 //usage: IF_FEATURE_DATE_COMPAT(
133 //usage: "\n 'date TIME' form accepts MMDDhhmm[[YY]YY][.ss] instead"
136 //usage:#define date_example_usage
138 //usage: "Wed Apr 12 18:52:41 MDT 2000\n"
141 #include "common_bufsiz.h"
142 #if ENABLE_FEATURE_DATE_NANO
143 # include <sys/syscall.h>
147 OPT_RFC2822 = (1 << 0), /* R */
148 OPT_SET = (1 << 1), /* s */
149 OPT_UTC = (1 << 2), /* u */
150 OPT_DATE = (1 << 3), /* d */
151 OPT_REFERENCE = (1 << 4), /* r */
152 OPT_TIMESPEC = (1 << 5) * ENABLE_FEATURE_DATE_ISOFMT, /* I */
153 OPT_HINT = (1 << 6) * ENABLE_FEATURE_DATE_ISOFMT, /* D */
156 static void maybe_set_utc(int opt)
159 putenv((char*)"TZ=UTC0");
163 static const char date_longopts[] ALIGN1 =
164 "rfc-822\0" No_argument "R"
165 "rfc-2822\0" No_argument "R"
166 "set\0" Required_argument "s"
167 "utc\0" No_argument "u"
168 /* "universal\0" No_argument "u" */
169 "date\0" Required_argument "d"
170 "reference\0" Required_argument "r"
174 int date_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
175 int date_main(int argc UNUSED_PARAM, char **argv)
179 char buf_fmt_dt2str[64];
186 char *isofmt_arg = NULL;
188 opt_complementary = "d--s:s--d"
189 IF_FEATURE_DATE_ISOFMT(":R--I:I--R");
190 IF_LONG_OPTS(applet_long_options = date_longopts;)
191 opt = getopt32(argv, "Rs:ud:r:"
192 IF_FEATURE_DATE_ISOFMT("I::D:"),
193 &date_str, &date_str, &filename
194 IF_FEATURE_DATE_ISOFMT(, &isofmt_arg, &fmt_str2dt));
198 if (ENABLE_FEATURE_DATE_ISOFMT && (opt & OPT_TIMESPEC)) {
199 ifmt = 0; /* default is date */
201 static const char isoformats[] ALIGN1 =
202 "date\0""hours\0""minutes\0""seconds\0"; /* ns? */
203 ifmt = index_in_substrings(isoformats, isofmt_arg);
210 if (argv[0] && argv[0][0] == '+') {
211 fmt_dt2str = &argv[0][1]; /* skip over the '+' */
214 if (!(opt & (OPT_SET | OPT_DATE))) {
216 date_str = argv[0]; /* can be NULL */
218 #if ENABLE_FEATURE_DATE_COMPAT
219 int len = strspn(date_str, "0123456789");
220 if (date_str[len] == '\0'
221 || (date_str[len] == '.'
222 && isdigit(date_str[len+1])
223 && isdigit(date_str[len+2])
224 && date_str[len+3] == '\0'
227 /* Dreaded MMDDhhmm[[CC]YY][.ss] format!
228 * It does not match -d or -s format.
229 * Some users actually do use it.
232 if (len < 0 || len > 4 || (len & 1))
233 bb_error_msg_and_die(bb_msg_invalid_date, date_str);
234 if (len != 0) { /* move YY or CCYY to front */
236 memcpy(buf, date_str + 8, len);
237 memmove(date_str + len, date_str, 8);
238 memcpy(date_str, buf, len);
248 /* Now we have parsed all the information except the date format
249 * which depends on whether the clock is being set or read */
251 if (opt & OPT_REFERENCE) {
253 xstat(filename, &statbuf);
254 ts.tv_sec = statbuf.st_mtime;
255 #if ENABLE_FEATURE_DATE_NANO
256 ts.tv_nsec = statbuf.st_mtim.tv_nsec;
257 /* Some toolchains use .st_mtimensec instead of st_mtim.tv_nsec.
258 * If you need #define _SVID_SOURCE 1 to enable st_mtim.tv_nsec,
259 * drop a mail to project mailing list please
263 #if ENABLE_FEATURE_DATE_NANO
264 /* libc has incredibly messy way of doing this,
265 * typically requiring -lrt. We just skip all this mess */
266 syscall(__NR_clock_gettime, CLOCK_REALTIME, &ts);
271 localtime_r(&ts.tv_sec, &tm_time);
273 /* If date string is given, update tm_time, and maybe set date */
274 if (date_str != NULL) {
275 /* Zero out fields - take her back to midnight! */
280 /* Process any date input to UNIX time since 1 Jan 1970 */
281 if (ENABLE_FEATURE_DATE_ISOFMT && (opt & OPT_HINT)) {
282 if (strptime(date_str, fmt_str2dt, &tm_time) == NULL)
283 bb_error_msg_and_die(bb_msg_invalid_date, date_str);
285 parse_datestr(date_str, &tm_time);
288 /* Correct any day of week and day of year etc. fields */
289 /* Be sure to recheck dst (but not if date is time_t format) */
290 if (date_str[0] != '@')
291 tm_time.tm_isdst = -1;
292 ts.tv_sec = validate_tm_time(date_str, &tm_time);
296 /* if setting time, set it */
297 if ((opt & OPT_SET) && stime(&ts.tv_sec) < 0) {
298 bb_perror_msg("can't set date");
304 /* Deal with format string */
305 if (fmt_dt2str == NULL) {
307 fmt_dt2str = buf_fmt_dt2str;
308 if (ENABLE_FEATURE_DATE_ISOFMT && ifmt >= 0) {
309 /* -I[SPEC]: 0:date 1:hours 2:minutes 3:seconds */
310 strcpy(fmt_dt2str, "%Y-%m-%dT%H:%M:%S");
313 /* TODO: if (ifmt==4) i += sprintf(&fmt_dt2str[i], ",%09u", nanoseconds); */
315 fmt_dt2str[i++] = '%';
316 fmt_dt2str[i++] = (opt & OPT_UTC) ? 'Z' : 'z';
318 fmt_dt2str[i] = '\0';
319 } else if (opt & OPT_RFC2822) {
320 /* -R. undo busybox.c setlocale */
321 if (ENABLE_LOCALE_SUPPORT)
322 setlocale(LC_TIME, "C");
323 strcpy(fmt_dt2str, "%a, %d %b %Y %H:%M:%S ");
324 i = sizeof("%a, %d %b %Y %H:%M:%S ")-1;
326 } else { /* default case */
327 fmt_dt2str = (char*)"%a %b %e %H:%M:%S %Z %Y";
330 #if ENABLE_FEATURE_DATE_NANO
332 /* User-specified fmt_dt2str */
333 /* Search for and process "%N" */
334 char *p = fmt_dt2str;
335 while ((p = strchr(p, '%')) != NULL) {
337 unsigned pres, scale;
344 n = strspn(p, "0123456789");
349 /* We have "%[nnn]N" */
355 pres = xatoi_positive(p);
365 fmt_dt2str = xasprintf("%s%0*u%s", fmt_dt2str, pres, (unsigned)ts.tv_nsec / scale, p);
371 #define date_buf bb_common_bufsiz1
372 #define sizeof_date_buf COMMON_BUFSIZE
373 if (*fmt_dt2str == '\0') {
374 /* With no format string, just print a blank line */
377 /* Handle special conversions */
378 if (is_prefixed_with(fmt_dt2str, "%f")) {
379 fmt_dt2str = (char*)"%Y.%m.%d-%H:%M:%S";
381 /* Generate output string */
382 strftime(date_buf, sizeof_date_buf, fmt_dt2str, &tm_time);