* * * * * */ const AUTOFILTER_COLUMN_RULE_EQUAL = 'equal'; const AUTOFILTER_COLUMN_RULE_NOTEQUAL = 'notEqual'; const AUTOFILTER_COLUMN_RULE_GREATERTHAN = 'greaterThan'; const AUTOFILTER_COLUMN_RULE_GREATERTHANOREQUAL = 'greaterThanOrEqual'; const AUTOFILTER_COLUMN_RULE_LESSTHAN = 'lessThan'; const AUTOFILTER_COLUMN_RULE_LESSTHANOREQUAL = 'lessThanOrEqual'; private static $operators = [ self::AUTOFILTER_COLUMN_RULE_EQUAL, self::AUTOFILTER_COLUMN_RULE_NOTEQUAL, self::AUTOFILTER_COLUMN_RULE_GREATERTHAN, self::AUTOFILTER_COLUMN_RULE_GREATERTHANOREQUAL, self::AUTOFILTER_COLUMN_RULE_LESSTHAN, self::AUTOFILTER_COLUMN_RULE_LESSTHANOREQUAL, ]; const AUTOFILTER_COLUMN_RULE_TOPTEN_BY_VALUE = 'byValue'; const AUTOFILTER_COLUMN_RULE_TOPTEN_PERCENT = 'byPercent'; private static $topTenValue = [ self::AUTOFILTER_COLUMN_RULE_TOPTEN_BY_VALUE, self::AUTOFILTER_COLUMN_RULE_TOPTEN_PERCENT, ]; const AUTOFILTER_COLUMN_RULE_TOPTEN_TOP = 'top'; const AUTOFILTER_COLUMN_RULE_TOPTEN_BOTTOM = 'bottom'; private static $topTenType = [ self::AUTOFILTER_COLUMN_RULE_TOPTEN_TOP, self::AUTOFILTER_COLUMN_RULE_TOPTEN_BOTTOM, ]; // Rule Operators (Numeric, Boolean etc) // const AUTOFILTER_COLUMN_RULE_BETWEEN = 'between'; // greaterThanOrEqual 1 && lessThanOrEqual 2 // Rule Operators (Numeric Special) which are translated to standard numeric operators with calculated values // const AUTOFILTER_COLUMN_RULE_TOPTEN = 'topTen'; // greaterThan calculated value // const AUTOFILTER_COLUMN_RULE_TOPTENPERCENT = 'topTenPercent'; // greaterThan calculated value // const AUTOFILTER_COLUMN_RULE_ABOVEAVERAGE = 'aboveAverage'; // Value is calculated as the average // const AUTOFILTER_COLUMN_RULE_BELOWAVERAGE = 'belowAverage'; // Value is calculated as the average // Rule Operators (String) which are set as wild-carded values // const AUTOFILTER_COLUMN_RULE_BEGINSWITH = 'beginsWith'; // A* // const AUTOFILTER_COLUMN_RULE_ENDSWITH = 'endsWith'; // *Z // const AUTOFILTER_COLUMN_RULE_CONTAINS = 'contains'; // *B* // const AUTOFILTER_COLUMN_RULE_DOESNTCONTAIN = 'notEqual'; // notEqual *B* // Rule Operators (Date Special) which are translated to standard numeric operators with calculated values // const AUTOFILTER_COLUMN_RULE_BEFORE = 'lessThan'; // const AUTOFILTER_COLUMN_RULE_AFTER = 'greaterThan'; // const AUTOFILTER_COLUMN_RULE_YESTERDAY = 'yesterday'; // const AUTOFILTER_COLUMN_RULE_TODAY = 'today'; // const AUTOFILTER_COLUMN_RULE_TOMORROW = 'tomorrow'; // const AUTOFILTER_COLUMN_RULE_LASTWEEK = 'lastWeek'; // const AUTOFILTER_COLUMN_RULE_THISWEEK = 'thisWeek'; // const AUTOFILTER_COLUMN_RULE_NEXTWEEK = 'nextWeek'; // const AUTOFILTER_COLUMN_RULE_LASTMONTH = 'lastMonth'; // const AUTOFILTER_COLUMN_RULE_THISMONTH = 'thisMonth'; // const AUTOFILTER_COLUMN_RULE_NEXTMONTH = 'nextMonth'; // const AUTOFILTER_COLUMN_RULE_LASTQUARTER = 'lastQuarter'; // const AUTOFILTER_COLUMN_RULE_THISQUARTER = 'thisQuarter'; // const AUTOFILTER_COLUMN_RULE_NEXTQUARTER = 'nextQuarter'; // const AUTOFILTER_COLUMN_RULE_LASTYEAR = 'lastYear'; // const AUTOFILTER_COLUMN_RULE_THISYEAR = 'thisYear'; // const AUTOFILTER_COLUMN_RULE_NEXTYEAR = 'nextYear'; // const AUTOFILTER_COLUMN_RULE_YEARTODATE = 'yearToDate'; // // const AUTOFILTER_COLUMN_RULE_ALLDATESINMONTH = 'allDatesInMonth'; // for Month/February // const AUTOFILTER_COLUMN_RULE_ALLDATESINQUARTER = 'allDatesInQuarter'; // for Quarter 2 /** * Autofilter Column. * * @var Column */ private $parent; /** * Autofilter Rule Type. * * @var string */ private $ruleType = self::AUTOFILTER_RULETYPE_FILTER; /** * Autofilter Rule Value. * * @var string */ private $value = ''; /** * Autofilter Rule Operator. * * @var string */ private $operator = self::AUTOFILTER_COLUMN_RULE_EQUAL; /** * DateTimeGrouping Group Value. * * @var string */ private $grouping = ''; /** * Create a new Rule. * * @param Column $pParent */ public function __construct(?Column $pParent = null) { $this->parent = $pParent; } /** * Get AutoFilter Rule Type. * * @return string */ public function getRuleType() { return $this->ruleType; } /** * Set AutoFilter Rule Type. * * @param string $pRuleType see self::AUTOFILTER_RULETYPE_* * * @return $this */ public function setRuleType($pRuleType) { if (!in_array($pRuleType, self::$ruleTypes)) { throw new PhpSpreadsheetException('Invalid rule type for column AutoFilter Rule.'); } $this->ruleType = $pRuleType; return $this; } /** * Get AutoFilter Rule Value. * * @return string */ public function getValue() { return $this->value; } /** * Set AutoFilter Rule Value. * * @param string|string[] $pValue * * @return $this */ public function setValue($pValue) { if (is_array($pValue)) { $grouping = -1; foreach ($pValue as $key => $value) { // Validate array entries if (!in_array($key, self::$dateTimeGroups)) { // Remove any invalid entries from the value array unset($pValue[$key]); } else { // Work out what the dateTime grouping will be $grouping = max($grouping, array_search($key, self::$dateTimeGroups)); } } if (count($pValue) == 0) { throw new PhpSpreadsheetException('Invalid rule value for column AutoFilter Rule.'); } // Set the dateTime grouping that we've anticipated $this->setGrouping(self::$dateTimeGroups[$grouping]); } $this->value = $pValue; return $this; } /** * Get AutoFilter Rule Operator. * * @return string */ public function getOperator() { return $this->operator; } /** * Set AutoFilter Rule Operator. * * @param string $pOperator see self::AUTOFILTER_COLUMN_RULE_* * * @return $this */ public function setOperator($pOperator) { if (empty($pOperator)) { $pOperator = self::AUTOFILTER_COLUMN_RULE_EQUAL; } if ( (!in_array($pOperator, self::$operators)) && (!in_array($pOperator, self::$topTenValue)) ) { throw new PhpSpreadsheetException('Invalid operator for column AutoFilter Rule.'); } $this->operator = $pOperator; return $this; } /** * Get AutoFilter Rule Grouping. * * @return string */ public function getGrouping() { return $this->grouping; } /** * Set AutoFilter Rule Grouping. * * @param string $pGrouping * * @return $this */ public function setGrouping($pGrouping) { if ( ($pGrouping !== null) && (!in_array($pGrouping, self::$dateTimeGroups)) && (!in_array($pGrouping, self::$dynamicTypes)) && (!in_array($pGrouping, self::$topTenType)) ) { throw new PhpSpreadsheetException('Invalid rule type for column AutoFilter Rule.'); } $this->grouping = $pGrouping; return $this; } /** * Set AutoFilter Rule. * * @param string $pOperator see self::AUTOFILTER_COLUMN_RULE_* * @param string|string[] $pValue * @param string $pGrouping * * @return $this */ public function setRule($pOperator, $pValue, $pGrouping = null) { $this->setOperator($pOperator); $this->setValue($pValue); // Only set grouping if it's been passed in as a user-supplied argument, // otherwise we're calculating it when we setValue() and don't want to overwrite that // If the user supplies an argumnet for grouping, then on their own head be it if ($pGrouping !== null) { $this->setGrouping($pGrouping); } return $this; } /** * Get this Rule's AutoFilter Column Parent. * * @return Column */ public function getParent() { return $this->parent; } /** * Set this Rule's AutoFilter Column Parent. * * @param Column $pParent * * @return $this */ public function setParent(?Column $pParent = null) { $this->parent = $pParent; return $this; } /** * Implement PHP __clone to create a deep clone, not just a shallow copy. */ public function __clone() { $vars = get_object_vars($this); foreach ($vars as $key => $value) { if (is_object($value)) { if ($key == 'parent') { // Detach from autofilter column parent $this->$key = null; } else { $this->$key = clone $value; } } else { $this->$key = $value; } } } }