whole_func_string: function advanceYears (d, yearsInTheFuture, adjustForWeekend) {
                      if(!(d instanceof Date)) return d;
                      yearsInTheFuture = yearsInTheFuture && libs.generic.isNumeric(yearsInTheFuture) ? yearsInTheFuture : 1;
                      d.setTime(d.getTime() + (yearsInTheFuture * 31536000000));
  
                      if(adjustForWeekend && (d.getDay() === 0 || d.getDay() === 6)) {
                          while(d.getDay() === 0 || d.getDay() === 6) d.setTime(d.getTime() + 86400000);
                      }
                      return d;
                  }
func_code_string: function advanceYears (d, yearsInTheFuture, adjustForWeekend) {
                      if(!(d instanceof Date)) return d;
                      yearsInTheFuture = yearsInTheFuture && libs.generic.isNumeric(yearsInTheFuture) ? yearsInTheFuture : 1;
                      d.setTime(d.getTime() + (yearsInTheFuture * 31536000000));
  
                      if(adjustForWeekend && (d.getDay() === 0 || d.getDay() === 6)) {
                          while(d.getDay() === 0 || d.getDay() === 6) d.setTime(d.getTime() + 86400000);
                      }
                      return d;
                  }
func_documentation_string: Moves a date forward 'yearsInTheFuture' years.
  @param {Date} The date object to operate on.
  @param {Number} yearsInTheFuture The number of years in the future to advance the date
  @param {Boolean=} [adjustForWeekend=false] Whether or not the date should fall on a weekend day
  @returns {Date} The date, adjusted the number of specified years.
  @function