Arduino: How to calculate day of week from date

 I wanted to add some code to a program that could detect if a clock was running during daylight saving and making an appropriate adjustment. To do this I needed to be able to test if a day was a Sunday (as that is the day when clocks are usually moved back and forth depending upon season).

Some real-time clock libraries have this function built in but the one I was targeting <RTCZero> was going to need some help.

I developed a function to calculate a day of the week from a supplied date and tested it with an interactive program (using the Serial Monitor of the IDE) that will run just fine on an Arduino UNO. The serial speed is set at only 9600 so that the code works with the IDE2 Serial Monitor (still broken I note) but if you are using the earlier version of the IDE then you can set a higher rate.

To test the function, just type a date in dd/mm/yyyy format (so a UK format) into the outbound message box of the Serial Monitor and hit the <Return> key. You do not need to set leading zero values for the day or month - 1/2/2022 is just fine.

The day of the week function returns a 1 for a Sunday through a 7 for a Saturday.

The first listing is easy to copy an paste into your IDE and the second is more human readable.

char dayList[][10] = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"};
char dateBuffer[11];
char sChar;
int buffCount = 0;
template<class T> inline Print &operator<<(Print &obj, T arg) {
  obj.print(arg); return obj;}
void setup() {
  Serial.begin(9600); // slow so this works with IDE 2 Serial monitor
  while (!Serial) {}
  clearBuffer();
  Serial << "Please set Serial Monitor line ending to NL & CR\n";
  Serial << "Then enter dates in dd/mm/yyyy format and press <return>\n";
}
void loop() {
  if ( Serial.available()){
    sChar = Serial.read();
    switch (sChar){
      case 10:
      case 13:
        if(buffCount >= 8){
          String dt = dateBuffer;
          int daySlash = dt.indexOf(('/'));
          int monthSlash = dt.indexOf('/', daySlash + 1);
          int res = dayOfWeek(dt.substring(0, daySlash).toInt(), dt.substring(daySlash + 1, monthSlash).toInt(), dt.substring(monthSlash + 1).toInt());
          Serial << '\n' << dateBuffer << " is a " << dayList[res -1] << '\n';
          Serial << "Try another one\n";
        }
        clearBuffer();
        break;
      default:
        if(buffCount <= 10){
          dateBuffer[buffCount++] = sChar;
        }
    }
  }
}
int dayOfWeek(int d, int m, int y){
  // note arguments are not validated
  bool leapYear = false;
  if((y % 4 == 0 && y % 100 != 0) || y % 400 == 0){
    leapYear = true;
  }
  while (y > 2299){ y -=400;} // extend function to before 1900 and beyond 2299
  while (y < 1900) {y += 400;}
  int century = y / 100;
  int yearInC = y % 100;
  int cValue = 0; // default for 21st C
  switch(century){
    case 19:
      cValue = 1;
      break;
    case 21:
      cValue = 5;
      break;
    case 22:
      cValue = 3;
      break;
  }
  int mValue = 0; // good for month 10
  switch(m) {
    case 1:
      if(leapYear) { mValue = 6;}
      break;
    case 2:
      mValue = leapYear ? 2 : 3;
      break;
    case 3:
    case 11:
      mValue = 3;
      break;
    case 4:
    case 7:
      mValue = 6;
      break;
    case 5:
      mValue = 1;
      break;
    case 6:
      mValue = 4;
      break;
    case 8:
      mValue = 2;
      break;
    case 9:
    case 12:
      mValue = 5;
      break;
  }
  int aValue = d + mValue + yearInC + cValue + yearInC / 4;
  int dValue = aValue % 7;
  return dValue > 0 ? dValue : 7; // Sunday 1, Saturday 7
}
void clearBuffer(){
  memset(dateBuffer, 0, 11);
  buffCount = 0;
}


char dayList[][10] = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"};
char dateBuffer[11];
char sChar;
int buffCount = 0;

template<class T> inline Print &operator<<(Print &obj, T arg) {
  obj.print(arg); return obj;}

void setup() {
  Serial.begin(9600); // slow so this works with IDE 2 Serial monitor
  while (!Serial) {}
  clearBuffer();
  Serial << "Please set Serial Monitor line ending to NL & CR\n";
  Serial << "Then enter dates in dd/mm/yyyy format and press <return>\n";
}

void loop() {
  if ( Serial.available()){
    sChar = Serial.read();
    switch (sChar){
      case 10:
      case 13:
        if(buffCount >= 8){
          String dt = dateBuffer;
          int daySlash = dt.indexOf(('/'));
          int monthSlash = dt.indexOf('/', daySlash + 1);
          int res = dayOfWeek(dt.substring(0, daySlash).toInt(), dt.substring(daySlash + 1, monthSlash).toInt(), dt.substring(monthSlash + 1).toInt());
          Serial << '\n' << dateBuffer << " is a " << dayList[res -1] << '\n';
          Serial << "Try another one\n";
        }
        clearBuffer();
        break;
      default:
        if(buffCount <= 10){
          dateBuffer[buffCount++] = sChar;
        }
    }
  }
}
int dayOfWeek(int d, int m, int y){
  // note arguments are not validated
  bool leapYear = false;
  if((y % 4 == 0 && y % 100 != 0) || y % 400 == 0){
    leapYear = true;
  }
  while (y > 2299){ y -=400;} // extend function to before 1900 and beyond 2299
  while (y < 1900) {y += 400;}
  int century = y / 100;
  int yearInC = y % 100;
  int cValue = 0; // default for 21st C
  switch(century){
    case 19:
      cValue = 1;
      break;
    case 21:
      cValue = 5;
      break;
    case 22:
      cValue = 3;
      break;
  }
  int mValue = 0; // good for month 10
  switch(m) {
    case 1:
      if(leapYear) { mValue = 6;}
      break;
    case 2:
      mValue = leapYear ? 2 : 3;
      break;
    case 3:
    case 11:
      mValue = 3;
      break;
    case 4:
    case 7:
      mValue = 6;
      break;
    case 5:
      mValue = 1;
      break;
    case 6:
      mValue = 4;
      break;
    case 8:
      mValue = 2;
      break;
    case 9:
    case 12:
      mValue = 5;
      break;
  }
  int aValue = d + mValue + yearInC + cValue + yearInC / 4;
  int dValue = aValue % 7;
  return dValue > 0 ? dValue : 7; // Sunday 1, Saturday 7
}
void clearBuffer(){
  memset(dateBuffer, 0, 11);
  buffCount = 0;
}

Let me know if you hit any problems.


Comments

Post a Comment

Popular posts from this blog

Unicode output from an Arduino.

Image
I have been working hard on a second edition for my book called "Practical Arduino C". The new edition has an extra chapter focusing on adding an Internet capability to Arduino boards plus some additional data structures. Overall, the text has been polished and the index extended and tidied. I have also changed the way the book is being published and sold. This has halved the retail price while still ensuring fast delivery when ordered from Amazon ( Amazon UK link here ). One item that featured in the first edition has been dropped as with hindsight it became clear that it did not add to the reader's learning experience. It made sense therefore to move the section on Unicode output over the Arduino serial interface to a blog post here. Unicode Characters The Arduino C is a great tool for manipulating, displaying and communicating ASCII encoded characters, which is perfect if the language you want to use is based upon the Latin character set. Most recent programming...
Read more

Arduino Regular Expressions

The first chapter of a wonderful book titled “Beautiful Code” (O’Reilly 2007) was written by Brian Kernighan who described an episode from when he and Rob Pyke were writing a book together called “The Practice of Programming”. They wanted to include a discussion on regular expressions but also wanted to include the code of an implementation. Existing code bases would have been a book length by themselves. Rob Pyke developed 30 lines of C code in less than two hours that implements a substantial part of the day to day usage of regular expressions. The code can be described as beautiful for its elegant efficiency. The final line of the chapter reads “I don’t know of another piece of code that does so much in so few lines while providing such a rich source of insight and further ideas”. The code handles the following constructs: Character Meaning c Matches any literal character (in this case ‘c’) . (full stop) Matches any single character ...
Read more

Arduino: How to scroll long text on OLED screen

 While exploring a new and tiny SSD 1306 OLED screen as a useful user interface I hit on the need to scroll some longish text across the screen. This did not seem to be a feature of the Adafruit library I was using to run the device. So I am introducing this working demo of my solution to the problem. The solution is to position the start point of the text in steps towards the left and beyond the left hand edge of the screen. The screen "clips" the text and displays all it can across the width of the screen. The demo includes some fixed text at the top of the screen and scrolls the long text below. #include <SPI.h> #include <Wire.h> #include <Adafruit_SSD1306.h> #define SCREEN_WIDTH 128 // OLED display width, in pixels #define SCREEN_HEIGHT 32 // OLED display height, in pixels #define OLED_RESET -1 // Reset pin # (or -1 if sharing Arduino reset pin) #define SCREEN_ADDRESS 0x3C ///< See datasheet for Address; 0x3D for 128x64, 0x3C for 128x32 Adafr...
Read more