Add documentation for the rest of commands.
[git/dscho.git] / date.c
blobaa4fb3efef5f35d510c14c3a73d497143406f5e7
1 /*
2 * GIT - The information manager from hell
4 * Copyright (C) Linus Torvalds, 2005
5 */
7 #include <stdio.h>
8 #include <stdlib.h>
9 #include <string.h>
10 #include <ctype.h>
11 #include <time.h>
13 static time_t my_mktime(struct tm *tm)
15 static const int mdays[] = {
16 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334
18 int year = tm->tm_year - 70;
19 int month = tm->tm_mon;
20 int day = tm->tm_mday;
22 if (year < 0 || year > 129) /* algo only works for 1970-2099 */
23 return -1;
24 if (month < 0 || month > 11) /* array bounds */
25 return -1;
26 if (month < 2 || (year + 2) % 4)
27 day--;
28 return (year * 365 + (year + 1) / 4 + mdays[month] + day) * 24*60*60UL +
29 tm->tm_hour * 60*60 + tm->tm_min * 60 + tm->tm_sec;
32 static const char *month_names[] = {
33 "January", "February", "March", "April", "May", "June",
34 "July", "August", "September", "October", "November", "December"
37 static const char *weekday_names[] = {
38 "Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"
42 * Check these. And note how it doesn't do the summer-time conversion.
44 * In my world, it's always summer, and things are probably a bit off
45 * in other ways too.
47 static const struct {
48 const char *name;
49 int offset;
50 int dst;
51 } timezone_names[] = {
52 { "IDLW", -12, 0, }, /* International Date Line West */
53 { "NT", -11, 0, }, /* Nome */
54 { "CAT", -10, 0, }, /* Central Alaska */
55 { "HST", -10, 0, }, /* Hawaii Standard */
56 { "HDT", -10, 1, }, /* Hawaii Daylight */
57 { "YST", -9, 0, }, /* Yukon Standard */
58 { "YDT", -9, 1, }, /* Yukon Daylight */
59 { "PST", -8, 0, }, /* Pacific Standard */
60 { "PDT", -8, 1, }, /* Pacific Daylight */
61 { "MST", -7, 0, }, /* Mountain Standard */
62 { "MDT", -7, 1, }, /* Mountain Daylight */
63 { "CST", -6, 0, }, /* Central Standard */
64 { "CDT", -6, 1, }, /* Central Daylight */
65 { "EST", -5, 0, }, /* Eastern Standard */
66 { "EDT", -5, 1, }, /* Eastern Daylight */
67 { "AST", -3, 0, }, /* Atlantic Standard */
68 { "ADT", -3, 1, }, /* Atlantic Daylight */
69 { "WAT", -1, 0, }, /* West Africa */
71 { "GMT", 0, 0, }, /* Greenwich Mean */
72 { "UTC", 0, 0, }, /* Universal (Coordinated) */
74 { "WET", 0, 0, }, /* Western European */
75 { "BST", 0, 1, }, /* British Summer */
76 { "CET", +1, 0, }, /* Central European */
77 { "MET", +1, 0, }, /* Middle European */
78 { "MEWT", +1, 0, }, /* Middle European Winter */
79 { "MEST", +1, 1, }, /* Middle European Summer */
80 { "CEST", +1, 1, }, /* Central European Summer */
81 { "MESZ", +1, 1, }, /* Middle European Summer */
82 { "FWT", +1, 0, }, /* French Winter */
83 { "FST", +1, 1, }, /* French Summer */
84 { "EET", +2, 0, }, /* Eastern Europe, USSR Zone 1 */
85 { "EEST", +2, 1, }, /* Eastern European Daylight */
86 { "WAST", +7, 0, }, /* West Australian Standard */
87 { "WADT", +7, 1, }, /* West Australian Daylight */
88 { "CCT", +8, 0, }, /* China Coast, USSR Zone 7 */
89 { "JST", +9, 0, }, /* Japan Standard, USSR Zone 8 */
90 { "EAST", +10, 0, }, /* Eastern Australian Standard */
91 { "EADT", +10, 1, }, /* Eastern Australian Daylight */
92 { "GST", +10, 0, }, /* Guam Standard, USSR Zone 9 */
93 { "NZT", +11, 0, }, /* New Zealand */
94 { "NZST", +11, 0, }, /* New Zealand Standard */
95 { "NZDT", +11, 1, }, /* New Zealand Daylight */
96 { "IDLE", +12, 0, }, /* International Date Line East */
99 #define NR_TZ (sizeof(timezone_names) / sizeof(timezone_names[0]))
101 static int match_string(const char *date, const char *str)
103 int i = 0;
105 for (i = 0; *date; date++, str++, i++) {
106 if (*date == *str)
107 continue;
108 if (toupper(*date) == toupper(*str))
109 continue;
110 if (!isalnum(*date))
111 break;
112 return 0;
114 return i;
117 static int skip_alpha(const char *date)
119 int i = 0;
120 do {
121 i++;
122 } while (isalpha(date[i]));
123 return i;
127 * Parse month, weekday, or timezone name
129 static int match_alpha(const char *date, struct tm *tm, int *offset)
131 int i;
133 for (i = 0; i < 12; i++) {
134 int match = match_string(date, month_names[i]);
135 if (match >= 3) {
136 tm->tm_mon = i;
137 return match;
141 for (i = 0; i < 7; i++) {
142 int match = match_string(date, weekday_names[i]);
143 if (match >= 3) {
144 tm->tm_wday = i;
145 return match;
149 for (i = 0; i < NR_TZ; i++) {
150 int match = match_string(date, timezone_names[i].name);
151 if (match >= 3) {
152 int off = timezone_names[i].offset;
154 /* This is bogus, but we like summer */
155 off += timezone_names[i].dst;
157 /* Only use the tz name offset if we don't have anything better */
158 if (*offset == -1)
159 *offset = 60*off;
161 return match;
165 if (match_string(date, "PM") == 2) {
166 if (tm->tm_hour > 0 && tm->tm_hour < 12)
167 tm->tm_hour += 12;
168 return 2;
171 /* BAD CRAP */
172 return skip_alpha(date);
175 static int is_date(int year, int month, int day, struct tm *tm)
177 if (month > 0 && month < 13 && day > 0 && day < 32) {
178 if (year == -1) {
179 tm->tm_mon = month-1;
180 tm->tm_mday = day;
181 return 1;
183 if (year >= 1970 && year < 2100) {
184 year -= 1900;
185 } else if (year > 70 && year < 100) {
186 /* ok */
187 } else if (year < 38) {
188 year += 100;
189 } else
190 return 0;
192 tm->tm_mon = month-1;
193 tm->tm_mday = day;
194 tm->tm_year = year;
195 return 1;
197 return 0;
200 static int match_multi_number(unsigned long num, char c, char *date, char *end, struct tm *tm)
202 long num2, num3;
204 num2 = strtol(end+1, &end, 10);
205 num3 = -1;
206 if (*end == c && isdigit(end[1]))
207 num3 = strtol(end+1, &end, 10);
209 /* Time? Date? */
210 switch (c) {
211 case ':':
212 if (num3 < 0)
213 num3 = 0;
214 if (num < 25 && num2 >= 0 && num2 < 60 && num3 >= 0 && num3 <= 60) {
215 tm->tm_hour = num;
216 tm->tm_min = num2;
217 tm->tm_sec = num3;
218 break;
220 return 0;
222 case '-':
223 case '/':
224 if (num > 70) {
225 /* yyyy-mm-dd? */
226 if (is_date(num, num2, num3, tm))
227 break;
228 /* yyyy-dd-mm? */
229 if (is_date(num, num3, num2, tm))
230 break;
232 /* mm/dd/yy ? */
233 if (is_date(num3, num2, num, tm))
234 break;
235 /* dd/mm/yy ? */
236 if (is_date(num3, num, num2, tm))
237 break;
238 return 0;
240 return end - date;
244 * We've seen a digit. Time? Year? Date?
246 static int match_digit(char *date, struct tm *tm, int *offset)
248 int n;
249 char *end;
250 unsigned long num;
252 num = strtoul(date, &end, 10);
255 * Seconds since 1970? We trigger on that for anything after Jan 1, 2000
257 if (num > 946684800) {
258 time_t time = num;
259 if (gmtime_r(&time, tm))
260 return end - date;
264 * Check for special formats: num[:-/]num[same]num
266 switch (*end) {
267 case ':':
268 case '/':
269 case '-':
270 if (isdigit(end[1])) {
271 int match = match_multi_number(num, *end, date, end, tm);
272 if (match)
273 return match;
278 * None of the special formats? Try to guess what
279 * the number meant. We use the number of digits
280 * to make a more educated guess..
282 n = 0;
283 do {
284 n++;
285 } while (isdigit(date[n]));
287 /* Four-digit year or a timezone? */
288 if (n == 4) {
289 if (num <= 1200 && *offset == -1) {
290 unsigned int minutes = num % 100;
291 unsigned int hours = num / 100;
292 *offset = hours*60 + minutes;
293 } else if (num > 1900 && num < 2100)
294 tm->tm_year = num - 1900;
295 return n;
299 * NOTE! We will give precedence to day-of-month over month or
300 * year numebers in the 1-12 range. So 05 is always "mday 5",
301 * unless we already have a mday..
303 * IOW, 01 Apr 05 parses as "April 1st, 2005".
305 if (num > 0 && num < 32 && tm->tm_mday < 0) {
306 tm->tm_mday = num;
307 return n;
310 /* Two-digit year? */
311 if (n == 2 && tm->tm_year < 0) {
312 if (num < 10 && tm->tm_mday >= 0) {
313 tm->tm_year = num + 100;
314 return n;
316 if (num >= 70) {
317 tm->tm_year = num;
318 return n;
322 if (num > 0 && num < 32) {
323 tm->tm_mday = num;
324 } else if (num > 1900) {
325 tm->tm_year = num - 1900;
326 } else if (num > 70) {
327 tm->tm_year = num;
328 } else if (num > 0 && num < 13) {
329 tm->tm_mon = num-1;
332 return n;
335 static int match_tz(char *date, int *offp)
337 char *end;
338 int offset = strtoul(date+1, &end, 10);
339 int min, hour;
340 int n = end - date - 1;
342 min = offset % 100;
343 hour = offset / 100;
346 * Don't accept any random crap.. At least 3 digits, and
347 * a valid minute. We might want to check that the minutes
348 * are divisible by 30 or something too.
350 if (min < 60 && n > 2) {
351 offset = hour*60+min;
352 if (*date == '-')
353 offset = -offset;
355 *offp = offset;
357 return end - date;
360 /* Gr. strptime is crap for this; it doesn't have a way to require RFC2822
361 (i.e. English) day/month names, and it doesn't work correctly with %z. */
362 void parse_date(char *date, char *result, int maxlen)
364 struct tm tm;
365 int offset, sign;
366 time_t then;
368 memset(&tm, 0, sizeof(tm));
369 tm.tm_year = -1;
370 tm.tm_mon = -1;
371 tm.tm_mday = -1;
372 tm.tm_isdst = -1;
373 offset = -1;
375 for (;;) {
376 int match = 0;
377 unsigned char c = *date;
379 /* Stop at end of string or newline */
380 if (!c || c == '\n')
381 break;
383 if (isalpha(c))
384 match = match_alpha(date, &tm, &offset);
385 else if (isdigit(c))
386 match = match_digit(date, &tm, &offset);
387 else if ((c == '-' || c == '+') && isdigit(date[1]))
388 match = match_tz(date, &offset);
390 if (!match) {
391 /* BAD CRAP */
392 match = 1;
395 date += match;
398 /* mktime uses local timezone */
399 then = my_mktime(&tm);
400 if (offset == -1)
401 offset = (then - mktime(&tm)) / 60;
403 if (then == -1)
404 return;
406 then -= offset * 60;
408 sign = '+';
409 if (offset < 0) {
410 offset = -offset;
411 sign = '-';
414 snprintf(result, maxlen, "%lu %c%02d%02d", then, sign, offset/60, offset % 60);
417 void datestamp(char *buf, int bufsize)
419 time_t now;
420 int offset;
422 time(&now);
424 offset = my_mktime(localtime(&now)) - now;
425 offset /= 60;
427 snprintf(buf, bufsize, "%lu %+05d", now, offset/60*100 + offset%60);