';
}
/**
* Initializes the datepicker's data so calculations for disabled dates can be done.
*
* Returns an array with two values: the first and the last selectable dates, as UNIX timestamps.
*
* If a value does not apply (i.e. no starting or no ending date), the value will be "0".
*
* @return array Returns an array with two values: the first and the last selectable dates,
* as UNIX timestamps.
*
* @access private
*/
function _init()
{
// do these calculations only once
if (!isset($this->limits)) {
// get current system date
$system_date = time();
// check if the calendar has any restrictions
// calendar is future-only, starting today
// it means we have a starting date (the current system date), but no ending date
if ($this->attributes['direction'] === true) $this->first_selectable_date = $system_date;
// calendar is past only, ending today
// it means we have an ending date (the reference date), but no starting date
else if ($this->attributes['direction'] === false) $this->last_selectable_date = $system_date;
else if (
// if direction is not given as an array and the value is an integer > 0
(!is_array($this->attributes['direction']) && (int)($this->attributes['direction']) > 0) ||
// or direction is given as an array
(is_array($this->attributes['direction']) && (
// and first entry is boolean TRUE
$this->attributes['direction'][0] === true ||
// or a valid date
($tmp_start_date = $this->_is_format_valid($this->attributes['direction'][0])) ||
// or an integer > 0
(is_numeric($this->attributes['direction'][0]) && $this->attributes['direction'][0] > 0)
) && (
// and second entry is boolean FALSE
$this->attributes['direction'][1] === false ||
// or a valid date
($tmp_end_date = $this->_is_format_valid($this->attributes['direction'][1])) ||
// or integer >= 0
(is_numeric($this->attributes['direction'][1]) && $this->attributes['direction'][1] >= 0)
))
) {
// if an exact starting date was given, use that as a starting date
if (isset($tmp_start_date)) $this->first_selectable_date = $tmp_start_date;
// otherwise
else
// figure out the starting date
$this->first_selectable_date = strtotime('+' . (!is_array($this->attributes['direction']) ? (int)($this->attributes['direction']) : (int)($this->attributes['direction'][0] === true ? 0 : $this->attributes['direction'][0])) . ' day', $system_date);
// if an exact ending date was given and the date is after the starting date, use that as a ending date
if (isset($tmp_end_date) && $tmp_end_date >= $this->first_selectable_date) $this->last_selectable_date = $tmp_end_date;
// if have information about the ending date
else if (!isset($tmp_end_date) && $this->attributes['direction'][1] !== false && is_array($this->attributes['direction']))
// figure out the ending date
$this->last_selectable_date = strtotime('+' . (int)($this->attributes['direction'][1]) . ' day', $system_date);
} else if (
// if direction is not given as an array and the value is an integer < 0
(!is_array($this->attributes['direction']) && is_numeric($this->attributes['direction']) && $this->attributes['direction'] < 0) ||
// or direction is given as an array
(is_array($this->attributes['direction']) && (
// and first entry is boolean FALSE
$this->attributes['direction'][0] === false ||
// or an integer < 0
(is_numeric($this->attributes['direction'][0]) && $this->attributes['direction'][0] < 0)
) && (
// and second entry is integer >= 0
(is_numeric($this->attributes['direction'][1]) && $this->attributes['direction'][1] >= 0) ||
// or a valid date
($tmp_start_date = $this->_is_format_valid($this->attributes['direction'][1]))
))
) {
// figure out the ending date
$this->last_selectable_date = strtotime('+' . (!is_array($this->attributes['direction']) ? (int)($this->attributes['direction']) : (int)($this->attributes['direction'][0] === false ? 0 : $this->attributes['direction'][0])) . ' day', $system_date);
// if an exact starting date was given, and the date is before the ending date, use that as a starting date
if (isset($tmp_start_date) && $tmp_start_date < $this->last_selectable_date) $this->first_selectable_date = $tmp_start_date;
// if have information about the starting date
else if (!isset($tmp_start_date) && is_array($this->attributes['direction']))
// figure out the staring date
$this->first_selectable_date = strtotime('-' . (int)($this->attributes['direction'][1]) . ' day');
}
// if a first selectable date exists
if (isset($this->first_selectable_date)) {
// extract the date parts
$first_selectable_year = date('Y', $this->first_selectable_date);
$first_selectable_month = date('m', $this->first_selectable_date);
$first_selectable_day = date('d', $this->first_selectable_date);
}
// if a last selectable date exists
if (isset($this->last_selectable_date)) {
// extract the date parts
$last_selectable_year = date('Y', $this->last_selectable_date);
$last_selectable_month = date('m', $this->last_selectable_date);
$last_selectable_day = date('d', $this->last_selectable_date);
}
// if a first selectable date exists but is disabled, find the actual first selectable date
if (isset($this->first_selectable_date) && $this->_is_disabled($first_selectable_year, $first_selectable_month, $first_selectable_day)) {
// loop until we find the first selectable year
while ($this->_is_disabled($first_selectable_year)) {
// if calendar is past-only, decrement the year
if ($this->first_selectable_date < 0 || $this->first_selectable_date === false) $first_selectable_year--;
// otherwise, increment the year
else $first_selectable_year++;
// because we've changed years, reset the month to January
$first_selectable_month = 1;
}
// loop until we find the first selectable month
while ($this->_is_disabled($first_selectable_year, $first_selectable_month)) {
// if calendar is past-only, decrement the month
if ($this->first_selectable_date < 0 || $this->first_selectable_date === false) $first_selectable_month--;
// otherwise, increment the month
else $first_selectable_month++;
// if we moved to a following year
if ($first_selectable_month > 12) {
// increment the year
$first_selectable_year++;
// reset the month to January
$first_selectable_month = 1;
// if we moved to a previous year
} else if ($first_selectable_month < 1) {
// decrement the year
$first_selectable_year--;
// reset the month to January
$first_selectable_month = 1;
}
// because we've changed months, reset the day to the first day of the month
$first_selectable_day = 1;
}
// loop until we find the first selectable day
while ($this->_is_disabled($first_selectable_year, $first_selectable_month, $first_selectable_day))
// if calendar is past-only, decrement the day
if ($this->first_selectable_date < 0 || $this->first_selectable_date === false) $first_selectable_day--;
// otherwise, increment the day
else $first_selectable_day++;
// use mktime() to normalize the date
// for example, 2011 05 33 will be transformed to 2011 06 02
$this->first_selectable_date = mktime(12, 0, 0, $first_selectable_month, $first_selectable_day, $first_selectable_year);
// re-extract date parts from the normalized date
// as we use them in the current loop
// extract the date parts
$first_selectable_year = date('Y', $this->first_selectable_date);
$first_selectable_month = date('m', $this->first_selectable_date);
$first_selectable_day = date('d', $this->first_selectable_date);
}
// save first and last selectable dates, as UNIX timestamps (or "0" if does not apply)
$this->limits = array(isset($this->first_selectable_date) ? $this->first_selectable_date : 0, isset($this->last_selectable_date) ? $this->last_selectable_date : 0);
}
// return first and last selectable dates, as UNIX timestamps (or "0" if does not apply)
return $this->limits;
}
/**
* Checks if the enetered value is a valid date in the right format.
*
* @return mixed Returns the UNIX timestamp of the checked date, if the date has the correct format,
* or FALSE otherwise.
*
* @access private
*/
function _is_format_valid($date)
{
// the format we expect the date to be
// escape characters that would make sense as regular expression
$format = preg_quote($this->attributes['format']);
// parse the format and extract the characters that define the format
// (note that we're also capturing the offsets)
preg_match_all('/[dDjlNSwFmMnYyGHghaAisU]{1}/', $format, $matches, PREG_OFFSET_CAPTURE);
$regexp = array();
// iterate through the found characters
// and create the regular expression that we will use to see if the entered date is ok
foreach ($matches[0] as $match) {
switch ($match[0]) {
// day of the month, 2 digits with leading zeros, 01 to 31
case 'd': $regexp[] = '0[1-9]|[12][0-9]|3[01]'; break;
// a textual representation of a day, three letters, mon through sun
case 'D': $regexp[] = '[a-z]{3}'; break;
// day of the month without leading zeros, 1 to 31
case 'j': $regexp[] = '[1-9]|[12][0-9]|3[01]'; break;
// a full textual representation of the day of the week, sunday through saturday
case 'l': $regexp[] = '[a-z]+'; break;
// ISO-8601 numeric representation of the day of the week (added in PHP 5.1.0), 1 (for Monday) through 7 (for Sunday)
case 'N': $regexp[] = '[1-7]'; break;
// english ordinal suffix for the day of the month, 2 characters: st, nd, rd or th. works well with j
case 'S': $regexp[] = 'st|nd|rd|th'; break;
// numeric representation of the day of the week, 0 (for sunday) through 6 (for saturday)
case 'w': $regexp[] = '[0-6]'; break;
// a full textual representation of a month, such as january or march
case 'F': $regexp[] = '[a-z]+'; break;
// numeric representation of a month, with leading zeros, 01 through 12
case 'm': $regexp[] = '0[1-9]|1[012]+'; break;
// a short textual representation of a month, three letters, jan through dec
case 'M': $regexp[] = '[a-z]{3}'; break;
// numeric representation of a month, without leading zeros, 1 through 12
case 'n': $regexp[] = '[1-9]|1[012]'; break;
// a full numeric representation of a year, 4 digits examples: 1999 or 2003
case 'Y': $regexp[] = '[0-9]{4}'; break;
// a two digit representation of a year examples: 99 or 03
case 'y': $regexp[] = '[0-9]{2}'; break;
// 24-hour format of an hour without leading zeros, 0 through 23
case 'G': $regexp[] = '[0-9]|1[0-9]|2[0-3]'; break;
// 24-hour format of an hour with leading zeros, 00 through 23
case 'H': $regexp[] = '0[0-9]|1[0-9]|2[0-3]'; break;
// 12-hour format of an hour without leading zeros, 1 through 12
case 'g': $regexp[] = '[0-9]|1[0-2]'; break;
// 12-hour format of an hour with leading zeros, 01 through 12
case 'h': $regexp[] = '0[0-9]|1[0-2]'; break;
// lowercase ante meridiem and post meridiem am or pm
case 'a':
case 'A': $regexp[] = '(am|pm)'; break;
// minutes with leading zeros, 00 to 59
case 'i': $regexp[] = '[0-5][0-9]'; break;
// seconds, with leading zeros 00 through 59
case 's': $regexp[] = '[0-5][0-9]'; break;
}
}
// if format is defined
if (!empty($regexp)) {
// we will replace every format-related character in the format expression with
// the appropriate regular expression in order to see that valid data was entered
// as required by the character
// we are replacing from finish to start so that we don't mess up the offsets
// therefore, we need to reverse the array first
$matches[0] = array_reverse($matches[0]);
// how many characters to replace
$chars = count($matches[0]);
// iterate through the characters
foreach ($matches[0] as $index => $char)
// and replace them with the appropriate regular expression
$format = substr_replace($format, '(' . $regexp[$chars - $index - 1] . ')', $matches[0][$index][1], 1);
// the final regular expression to math the date against
$format = '/^' . str_replace('/', '\/', $format) . '$/i';
// if entered value seems to be ok
if (preg_match($format, $date, $segments)) {
$original_day = $original_month = $original_year = 0;
$original_hour = $original_minute = $original_second = $original_format = -1;
// english names for days and months
$english_days = array('Sunday','Monday','Tuesday','Wednesday','Thursday','Friday','Saturday');
$english_months = array('January','February','March','April','May','June','July','August','September','October','November','December');
// reverse the characters in the format (remember that we reversed them above)
$matches[0] = array_reverse($matches[0]);
$valid = true;
// iterate through the characters in the format
// to see if years, months, days, hours, minutes and seconds are correct
// i.e. if for month we entered "abc" it would pass our regular expression but
// now we will check if the three letter text is an actual month
foreach ($matches[0] as $index => $match) {
switch ($match[0]) {
// numeric representation of a month, with leading zeros, 01 through 12
case 'm':
// numeric representation of a month, without leading zeros, 1 through 12
case 'n':
$original_month = (int)($segments[$index + 1] - 1);
break;
// day of the month, 2 digits with leading zeros, 01 to 31
case 'd':
// day of the month without leading zeros, 1 to 31
case 'j':
$original_day = (int)($segments[$index + 1]);
break;
// a textual representation of a day, three letters, mon through sun
case 'D':
// a full textual representation of the day of the week, sunday through saturday
case 'l':
// a full textual representation of a month, such as january or march
case 'F':
// a short textual representation of a month, three letters, jan through dec
case 'M':
// by default, we assume that the text is invalid
$valid = false;
// iterate through the values in the language file
foreach ($this->form_properties['language'][($match[0] == 'F' || $match[0] == 'M' ? 'months' : 'days')] as $key => $value) {
// if value matches the value from the language file
if (strtolower($segments[$index + 1]) == strtolower(substr($value, 0, ($match[0] == 'D' || $match[0] == 'M' ? 3 : strlen($value))))) {
// replace with the english value
// this is because later on we'll run strtotime of the entered value and strtotime parses english dates
switch ($match[0]) {
case 'D': $segments[$index + 1] = substr($english_days[$key], 0, 3); break;
case 'l': $segments[$index + 1] = $english_days[$key]; break;
case 'F': $segments[$index + 1] = $english_months[$key]; $original_month = $key; break;
case 'M': $segments[$index + 1] = substr($english_months[$key], 0, 3); $original_month = $key; break;
}
// flag the value as valid
$valid = true;
// don't look further
break;
}
}
// if an invalid was found don't look any further
if (!$valid) break 2;
break;
// a full numeric representation of a year, 4 digits examples: 1999 or 2003
case 'Y':
$original_year = (int)($segments[$index + 1]);
break;
// a two digit representation of a year examples: 99 or 03
case 'y':
$original_year = (int)('19' . $segments[$index + 1]);
break;
// 24-hour format of an hour without leading zeros, 0 through 23
case 'G':
// 24-hour format of an hour with leading zeros, 00 through 23
case 'H':
// 12-hour format of an hour without leading zeros, 1 through 12
case 'g':
// 12-hour format of an hour with leading zeros, 01 through 12
case 'h':
$original_hour = (int)($segments[$index + 1]);
break;
// lowercase ante meridiem and post meridiem am or pm
case 'a':
case 'A':
$original_format = $segments[$index + 1];
break;
// minutes with leading zeros, 00 to 59
case 'i':
$original_minute = (int)($segments[$index + 1]);
break;
// seconds, with leading zeros 00 through 59
case 's':
$original_second = (int)($segments[$index + 1]);
break;
}
}
// if entered value seems valid
if ($valid) {
// if date format does not include day, make day = 1
if ($original_day == 0) $original_day = 1;
// if date format does not include month, make month = 0 (January)
if ($original_month == 0) $original_month = 0;
// if date format does not include year, use the current year
if ($original_year == 0) $original_year = date('Y');
// if date is still valid after we process it with strtotime
// (we do this because, so far, a date like "Feb 31 2010" would be valid
// but strtotime would turn that to "Mar 03 2010")
if (
$english_months[$original_month] . ' ' . str_pad($original_day, 2, '0', STR_PAD_LEFT) . ', ' . $original_year ==
date('F d, Y', strtotime($english_months[$original_month] . ' ' . $original_day . ', ' . $original_year))
) {
// make sure we also return the date as YYYY-MM-DD so that it can be
// easily used with a database or with PHP's strtotime function
$this->attributes['date'] = $original_year . '-' . str_pad($original_month + 1, 2, '0', STR_PAD_LEFT) . '-' . str_pad($original_day, 2, '0', STR_PAD_LEFT);
return strtotime($original_year . '-' . ($original_month + 1) . '-' . $original_day);
}
}
}
}
// if script gets this far, return FALSE as something must've been wrong
return false;
}
/**
* Checks if, according to the restrictions of the calendar and/or the values defined by the "disabled_dates"
* property, a day, a month or a year needs to be disabled.
*
* @param integer $year The year to check
* @param integer $month The month to check
* @param integer $day The day to check
*
* @return boolean Returns TRUE if the given value is not disabled or FALSE otherwise
*
* @access private
*/
function _is_disabled($year, $month = '', $day = '')
{
// parse the rules for disabling dates and turn them into arrays of arrays
if (!isset($this->disabled_dates)) {
// array that will hold the rules for disabling dates
$this->disabled_dates = array();
// if disabled dates is an array and is not empty
if (is_array($this->attributes['disabled_dates']) && !empty($this->attributes['disabled_dates']))
// iterate through the rules for disabling dates
foreach ($this->attributes['disabled_dates'] as $value) {
// split the values in rule by white space
$rules = explode(' ', $value);
// there can be a maximum of 4 rules (days, months, years and, optionally, day of the week)
for ($i = 0; $i < 4; $i++) {
// if one of the values is not available
// replace it with a * (wildcard)
if (!isset($rules[$i])) $rules[$i] = '*';
// if rule contains a comma, create a new array by splitting the rule by commas
// if there are no commas create an array containing the rule's string
$rules[$i] = (strpos($rules[$i], ',') !== false ? explode(',', $rules[$i]) : (array)$rules[$i]);
// iterate through the items in the rule
for ($j = 0; $j < count($rules[$i]); $j++)
// if item contains a dash (defining a range)
if (strpos($rules[$i][$j], '-') !== false) {
// get the lower and upper limits of the range
// if range is valid
if (preg_match('/^([0-9]+)\-([0-9]+)/', $rules[$i][$j], $limits) > 0) {
// remove the range indicator
array_splice($rules[$i], $j, 1);
// iterate through the range
for ($k = $limits[1]; $k <= $limits[2]; $k++)
// if value is not already among the values of the rule
// add it to the rule
if (!in_array($k, $rules[$i])) $rules[$i][] = (int)$k;
}
// make sure to convert things like "01" to "1"
} elseif ($rules[$i][$j] != '*') $rules[$i][$j] = (int)$rules[$i][$j];
}
// add to the list of processed rules
$this->disabled_dates[] = $rules;
}
}
// if calendar has direction restrictions
if (!(!is_array($this->attributes['direction']) && (int)($this->attributes['direction']) === 0)) {
// if a first selectable date exists
if (isset($this->first_selectable_date)) {
// extract the date parts
$first_selectable_year = date('Y', $this->first_selectable_date);
$first_selectable_month = date('m', $this->first_selectable_date);
$first_selectable_day = date('d', $this->first_selectable_date);
}
// if a last selectable date exists
if (isset($this->last_selectable_date)) {
// extract the date parts
$last_selectable_year = date('Y', $this->last_selectable_date);
$last_selectable_month = date('m', $this->last_selectable_date);
$last_selectable_day = date('d', $this->last_selectable_date);
}
// normalize and merge arguments then transform the result to an integer
$now = $year . ($month != '' ? str_pad($month, 2, '0', STR_PAD_LEFT) : '') . ($day != '' ? str_pad($day, 2, '0', STR_PAD_LEFT) : '');
// if we're checking days
if (strlen($now) == 8 && (
// day is before the first selectable date
(isset($this->first_selectable_date) && $now < $first_selectable_year . $first_selectable_month . $first_selectable_day) ||
// or day is after the last selectable date
(isset($this->last_selectable_date) && $now > $last_selectable_year . $last_selectable_month . $last_selectable_day)
// day needs to be disabled
)) return true;
// if we're checking months
else if (strlen($now) == 6 && (
// month is before the first selectable month
(isset($this->first_selectable_date) && $now < $first_selectable_year . $first_selectable_month) ||
// or month is after the last selectable month
(isset($this->last_selectable_date) && $now > $last_selectable_year . $last_selectable_month)
// month needs to be disabled
)) return true;
// if we're checking years
else if (strlen($now) == 4 && (
// year is before the first selectable year
(isset($this->first_selectable_date) && $now < $first_selectable_year) ||
// or year is after the last selectable year
(isset($this->last_selectable_date) && $now > $last_selectable_year)
// year needs to be disabled
)) return true;
}
// if there are rules for disabling dates
if (isset($this->disabled_dates)) {
// by default, we assume the day/month/year is not to be disabled
$disabled = false;
// iterate through the rules for disabling dates
foreach ($this->disabled_dates as $rule) {
// if the date is to be disabled, don't look any further
if ($disabled) return;
// if the rules apply for the current year
if (in_array($year, $rule[2]) || in_array('*', $rule[2], true))
// if the rules apply for the current month
if (($month != '' && in_array($month, $rule[1])) || in_array('*', $rule[1], true))
// if the rules apply for the current day
if (($day != '' && in_array($day, $rule[0])) || in_array('*', $rule[0], true)) {
// if day is to be disabled whatever the day
// don't look any further
if (in_array('*', $rule[3], true)) return ($disabled = true);
// get the weekday
$weekday = date('w', mktime(12, 0, 0, $month, $day, $year));
// if weekday is to be disabled
// don't look any further
if (in_array($weekday, $rule[3])) return ($disabled = true);
}
}
// if the day/month/year needs to be disabled
if ($disabled) return true;
}
// if script gets this far it means that the day/month/year doesn't need to be disabled
return false;
}
}
?>