## Overview

One of the tasks for GSoC 2019, was adding multiple datasets to calendar activities, but along with the task I also planned on adding another inprovement to the activity. The activity initially used hardcoded questions and answesr regarding calenders. The dataset for which looked like

``````data: [
{
"minimumDate": "2018-01-01",
"maximumDate": "2018-12-31",
"visibleMonth": 1,
"visibleYear": 2018,
"mode": "findMonthOnly",
"questionsExplicitlyGiven": true,
{
"question": qsTr("Find the month starting a Thursday and having 28 days"),
},
{
"question": qsTr("Find a month starting a Monday and having 31 days"),
},
{
"question": qsTr("Find the month between June and August"),
},
{
"question": qsTr("Find a month starting a Saturday"),
},
{
"question": qsTr("Find a month having 30 days"),
"answer": {"month": [3, 5, 8, 10]}
}
]
}, ... and more levels so on
]
``````

So I planned on creating an algorithm that could generate some template questions and answers. The activity has four type of questions depending in the mode. The available modes are

``````      // findMonthOnly --> For questions based on finding month only.
// findYearMonthDay --> For questions based on finding year, month and day.
// findDayOfWeek --> For questions based on finding day of week only.
// findDay --> For questions based on finding day of a given month and year.
``````

So, I the algorithm should generate different questions for each type.

## Function to generate date in Range

The first task is to create a function that would generate a random date within the given range i.e minDate and maxDate.

``````function generateRandomYearMonthDay(minimumDate, maximumDate) {
var minYear = Number(minimumDate.slice(0, 4))
var maxYear = Number(maximumDate.slice(0, 4))
var minMonth = Number(minimumDate.slice(5, 7))
var maxMonth = Number(maximumDate.slice(5, 7))
var minDate = Number(minimumDate.slice(8, 10))
var currentYear = minYear + Math.floor(Math.random() * Math.floor((maxYear - minYear + 1)))
var currentMonth = minMonth + Math.floor(Math.random() * Math.floor((maxMonth - minMonth + 1)))
var currentDate
daysInMonths[1] = (isLeapYear(currentYear)) ? 29 : 28;
currentDate = minDate + Math.floor(Math.random() * Math.floor((daysInMonths[currentMonth - 1] - minDate + 1)))
return { year: currentYear, month: currentMonth - 1, day: currentDate }
}
``````

There are some questions which require the user to find a date, a given number of days ahead of the current date. So I created a function to calculate that date.

``````function addOffsetToCurrentDate(currentDate) {
var offset = Math.floor(maxOffset / 2) + Math.floor(Math.random() * Math.floor(maxOffset))
daysInMonths[1] = (isLeapYear(currentDate.year)) ? 29 : 28;
offset += currentDate.day
while(offset > 0) {
if(offset - daysInMonths[answerMonth] > 0) {
} else {
offset = 0
}
daysInMonths[1] = (isLeapYear(answerYear)) ? 29 : 28;
}
}
}
``````

## Function to generate template questions

Now there has to be a function that would return the correct question text template as per the mode of the question. So I created a function for that.

``````function getTemplateQuestionText(mode, date) {
var questionText
if(mode == "findDayOfWeek") {
questionText = qsTr("What day of the week is on %1?").arg(getDateInLongFormat(date))
} else if(mode == "findDay") {
questionText = qsTr("Select day %1?").arg(date.day)
} else if(mode == "findMonthOnly") {
questionText = qsTr("Find month number %1").arg(date.month + 1)
} else {
if(date.offset) {
//: The second argument represents the given date in complete format(with complete month name) and the first argument represents the difference in days between given date and answer date.
questionText = qsTr("Find the date %1 days after %2").arg(date.offset).arg(getDateInLongFormat(date))
} else
//: The argument represents the answer date in complete format(with complete month name)
questionText = qsTr("Find the date %1").arg(getDateInLongFormat(date))
}
return questionText
}
``````

## Function to set question and answer values

Finally I created a function that would set the correct values of the question and answer variables as per the selected mode.

`````` if(!currentLevelConfig.questionsExplicitlyGiven) {
var randomDate = generateRandomYearMonthDay(currentLevelConfig.minimumDate, currentLevelConfig.maximumDate)
items.score.currentSubLevel = currentSubLevel
if(currentLevelConfig.mode == "findDayOfWeek") {
var selectedDate = new Date(randomDate.year, randomDate.month - 1, randomDate.day)
} else if(currentLevelConfig.mode == "findYearMonthDay" && currentLevelConfig.questionAnswers.maxOffset) {
} else {
}
items.questionItem.text = getTemplateQuestionText(currentLevelConfig.mode, randomDate)
}
``````

The part of code is executed only if the questions are not explicitly given.

## Dataset contents for template questions

If the dataset creater wants to use template function then he can define then like

``````{
"minimumDate": "2018-01-01",
"maximumDate": "2019-12-31",
"visibleMonth": 10,
"visibleYear": 2018,
"mode": "findYearMonthDay",
"questionsExplicitlyGiven": false,
"length": 5,
"maxOffset": 90
}
},
``````

where the variable length defines the length of questionSet or the number of questions.