{"id":414,"date":"2014-01-04T00:01:35","date_gmt":"2014-01-04T08:01:35","guid":{"rendered":"http:\/\/c-for-dummies.com\/blog\/?p=414"},"modified":"2014-01-18T09:09:00","modified_gmt":"2014-01-18T17:09:00","slug":"the-month-program-phase-i","status":"publish","type":"post","link":"https:\/\/c-for-dummies.com\/blog\/?p=414","title":{"rendered":"The Month Program, Phase I"},"content":{"rendered":"

Unix features a handy command line tool called cal<\/em>. When typed by its lonesome, cal<\/em> spits up a text calendar on the terminal window. Or you can follow cal<\/em> with a month and year value to see a specific month, or just the year value to see a year’s calendar. It’s nifty!
\n
\nHere’s the output of the cal<\/em> command for this month, January 2014:<\/p>\n

    January 2014\r\nSu Mo Tu We Th Fr Sa\r\n          1  2  3  4\r\n 5  6  7  8  9 10 11\r\n12 13 14 15 16 17 18\r\n19 20 21 22 23 24 25\r\n26 27 28 29 30 31<\/code><\/pre>\n
I use this command in my always-open terminal window as a quick way to check dates. It’s much faster than slugging my way through a GUI calendar or scheduling app. It’s even faster than flying in the Dashboard in OS X.<\/p>\n
But I want more!<\/p>\n
Specifically, I want the monthly calendar output to highlight the current day of the month.<\/p>\n
Ideally, it would look like this:<\/p>\n
    January 2014\r\nSu Mo Tu We Th Fr Sa\r\n          1  2  3  4<\/span>\r\n 5  6  7  8  9 10 11\r\n12 13 14 15 16 17 18\r\n19 20 21 22 23 24 25\r\n26 27 28 29 30 31<\/code><\/pre>\n
Such text coloring is possible by programming the terminal directly, using ANSI codes, or using the NCurses library<\/a>. Rather than muddy the waters, I’d settle for this type of output:<\/p>\n
    January 2014\r\nSu Mo Tu We Th Fr Sa\r\n          1  2  3[ 4]\r\n 5  6  7  8  9 10 11\r\n12 13 14 15 16 17 18\r\n19 20 21 22 23 24 25\r\n26 27 28 29 30 31<\/code><\/pre>\n
Above, I’m using square brackets to enclose the current day. That keeps with the text-only type of output C does, plus it’s a bit easier to code.<\/p>\n
Of course, it’s only easier when you can generate the current month in the first place. To do so, you have to really start by determining which day of the week is the first day of the current month. For that task, you need to use your standard C library toolbox and the localtime()<\/em> function.<\/p>\n
The localtime()<\/em> function (prototyped in the time.h<\/code> header) fills a tm<\/code> structure with information about a given Unix Epoch time value, also known as a time_t<\/code> value. Normally the value of time_t<\/code> reflects the current date and time, which is fetched by using the time()<\/em> function. You can also backfill that structure to fetch information about any specific date, which was demonstrated in a previous Lesson<\/a>.<\/p>\n
As a reference, here is the information found in the typical tm<\/code> structure:<\/p>\n
int tm_sec;     \/* seconds (0 - 60) *\/\r\nint tm_min;     \/* minutes (0 - 59) *\/\r\nint tm_hour;    \/* hours (0 - 23) *\/\r\nint tm_mday;    \/* day of month (1 - 31) *\/\r\nint tm_mon;     \/* month of year (0 - 11) *\/\r\nint tm_year;    \/* year - 1900 *\/\r\nint tm_wday;    \/* day of week (Sunday = 0) *\/\r\nint tm_yday;    \/* day of year (0 - 365) *\/\r\nint tm_isdst;   \/* is summer time in effect? *\/\r\nchar *tm_zone;  \/* abbreviation of timezone name *\/\r\nlong tm_gmtoff; \/* offset from UTC in seconds *\/\r\n<\/code><\/pre>\n
Some library implementations add more members, but what you see above is pretty common.<\/p>\n
The sample code below uses the tm<\/code> structure to display three relevant tidbits of information: The current day of the week, the current month, and the current day of the month.<\/p>\n
\r\n#include <stdio.h>\r\n#include <time.h>\r\n\r\nint main()\r\n{\r\n    time_t tictoc;\r\n    struct tm *rightnow;\r\n    int wday,monthday,month;\r\n    char *months[12] = {\r\n        \"January\", \"February\", \"March\", \"April\",\r\n        \"May\", \"June\", \"July\", \"August\",\r\n        \"September\", \"October\", \"November\", \"December\" };\r\n    char *weekdays[7] = {\r\n        \"Sunday\", \"Monday\", \"Tuesday\", \"Wednesday\",\r\n        \"Thursday\", \"Friday\", \"Saturday\" };\r\n\r\n    time(&tictoc);                  \/* get Unix epoch time *\/\r\n                                    \/* fill tm struct rightnow *\/\r\n    rightnow = localtime(&tictoc);\r\n                                    \/* Get info from struct *\/\r\n    wday = rightnow->tm_wday;       \/* 0=Sunday *\/\r\n    monthday = rightnow->tm_mday;   \/* 1 to 31 *\/\r\n    month = rightnow->tm_mon;       \/* 0=January *\/\r\n\r\n    printf(\"Today is %s %s %d\\n\",\r\n        weekdays[wday],\r\n        months[month],\r\n        monthday);\r\n\r\n    return(0);\r\n}<\/pre>\n
Sample output from this code depends on the current date. Here’s what I see:<\/p>\n
Today is Saturday January 4<\/code><\/p>\n
Once the program knows the current day of the month, the next step is to concoct an algorithm to determine on which day of the week the first would fall. You have all the information to do it on your own, or you can wait a week and continue with the next Lesson<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
The process of displaying the current month starts by fetching today’s date. You need three tidbits of information: The day of the week, the month, and the day of the month. Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-414","post","type-post","status-publish","format-standard","hentry","category-main"],"_links":{"self":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/414","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=414"}],"version-history":[{"count":14,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/414\/revisions"}],"predecessor-version":[{"id":535,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/414\/revisions\/535"}],"wp:attachment":[{"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=414"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=414"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c-for-dummies.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=414"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}