Yeelight /
cloud2
| Total Complexity | 182 |
| Total Lines | 1225 |
| Duplicated Lines | 0 % |
| Changes | 0 | ||
Complex classes like CronSchedule often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use CronSchedule, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 45 | class CronSchedule |
||
| 46 | { |
||
| 47 | // The actual minutes, hours, daysOfMonth, months, daysOfWeek and years selected by the provided cron specification. |
||
| 48 | private $_minutes = []; |
||
| 49 | private $_hours = []; |
||
| 50 | private $_daysOfMonth = []; |
||
| 51 | private $_months = []; |
||
| 52 | private $_daysOfWeek = []; |
||
| 53 | private $_years = []; |
||
| 54 | // The original cron specification in compiled form. |
||
| 55 | private $_cronMinutes = []; |
||
| 56 | private $_cronHours = []; |
||
| 57 | private $_cronDaysOfMonth = []; |
||
| 58 | private $_cronMonths = []; |
||
| 59 | private $_cronDaysOfWeek = []; |
||
| 60 | private $_cronYears = []; |
||
| 61 | // The language table |
||
| 62 | private $_lang = false; |
||
| 63 | /** |
||
| 64 | * Minimum and maximum years to cope with the Year 2038 problem in UNIX. We run PHP which most likely runs on a UNIX environment so we |
||
| 65 | * must assume vulnerability. |
||
| 66 | */ |
||
| 67 | protected $RANGE_YEARS_MIN = 1970; // Must match date range supported by date(). See also: http://en.wikipedia.org/wiki/Year_2038_problem |
||
| 68 | protected $RANGE_YEARS_MAX = 2037; // Must match date range supported by date(). See also: http://en.wikipedia.org/wiki/Year_2038_problem |
||
| 69 | |||
| 70 | /** |
||
| 71 | * Function: __construct. |
||
| 72 | * |
||
| 73 | * Description: Performs only base initialization, including language initialization. |
||
| 74 | * |
||
| 75 | * Parameters: $language The languagecode of the chosen language. |
||
| 76 | */ |
||
| 77 | public function __construct($language = 'en') |
||
| 78 | { |
||
| 79 | $this->initLang($language); |
||
| 80 | } |
||
| 81 | |||
| 82 | // |
||
| 83 | // Function: fromCronString |
||
| 84 | // |
||
| 85 | // Description: Creates a new Schedule object based on a Cron specification. |
||
| 86 | // |
||
| 87 | // Parameters: $cronSpec A string containing a cron specification. |
||
| 88 | // $language The language to use to create a natural language representation of the string |
||
| 89 | // |
||
| 90 | // Result: A new Schedule object. An \Exception is thrown if the specification is invalid. |
||
| 91 | // |
||
| 92 | final public static function fromCronString($cronSpec = '* * * * * *', $language = 'en') |
||
| 93 | { |
||
| 94 | // Split input liberal. Single or multiple Spaces, Tabs and Newlines are all allowed as separators. |
||
| 95 | if (count($elements = preg_split('/\s+/', $cronSpec)) < 5) { |
||
|
Bug
introduced
by
|
|||
| 96 | throw new \Exception('Invalid specification.'); |
||
| 97 | } |
||
| 98 | ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// |
||
| 99 | // Named ranges in cron entries |
||
| 100 | ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// |
||
| 101 | $arrMonths = ['JAN' => 1, 'FEB' => 2, 'MAR' => 3, 'APR' => 4, 'MAY' => 5, 'JUN' => 6, 'JUL' => 7, 'AUG' => 8, 'SEP' => 9, 'OCT' => 10, 'NOV' => 11, 'DEC' => 12]; |
||
| 102 | $arrDaysOfWeek = ['SUN' => 0, 'MON' => 1, 'TUE' => 2, 'WED' => 3, 'THU' => 4, 'FRI' => 5, 'SAT' => 6]; |
||
| 103 | // Translate the cron specification into arrays that hold specifications of the actual dates |
||
| 104 | $newCron = new self($language); |
||
| 105 | $newCron->_cronMinutes = $newCron->cronInterpret($elements[0], 0, 59, [], 'minutes'); |
||
| 106 | $newCron->_cronHours = $newCron->cronInterpret($elements[1], 0, 23, [], 'hours'); |
||
| 107 | $newCron->_cronDaysOfMonth = $newCron->cronInterpret($elements[2], 1, 31, [], 'daysOfMonth'); |
||
| 108 | $newCron->_cronMonths = $newCron->cronInterpret($elements[3], 1, 12, $arrMonths, 'months'); |
||
| 109 | $newCron->_cronDaysOfWeek = $newCron->cronInterpret($elements[4], 0, 6, $arrDaysOfWeek, 'daysOfWeek'); |
||
| 110 | $newCron->_minutes = $newCron->cronCreateItems($newCron->_cronMinutes); |
||
| 111 | $newCron->_hours = $newCron->cronCreateItems($newCron->_cronHours); |
||
| 112 | $newCron->_daysOfMonth = $newCron->cronCreateItems($newCron->_cronDaysOfMonth); |
||
| 113 | $newCron->_months = $newCron->cronCreateItems($newCron->_cronMonths); |
||
| 114 | $newCron->_daysOfWeek = $newCron->cronCreateItems($newCron->_cronDaysOfWeek); |
||
| 115 | if (isset($elements[5])) { |
||
| 116 | $newCron->_cronYears = $newCron->cronInterpret($elements[5], $newCron->RANGE_YEARS_MIN, $newCron->RANGE_YEARS_MAX, [], 'years'); |
||
| 117 | $newCron->_years = $newCron->cronCreateItems($newCron->_cronYears); |
||
| 118 | } |
||
| 119 | |||
| 120 | return $newCron; |
||
| 121 | } |
||
| 122 | |||
| 123 | /* |
||
| 124 | * Function: cronInterpret |
||
| 125 | * |
||
| 126 | * Description: Interprets a single field from a cron specification. Throws an \Exception if the specification is in some way invalid. |
||
| 127 | * |
||
| 128 | * Parameters: $specification The actual text from the spefication, such as 12-38/3 |
||
| 129 | * $rangeMin The lowest value for specification. |
||
| 130 | * $rangeMax The highest value for specification |
||
| 131 | * $namesItems A key/value pair where value is a value between $rangeMin and $rangeMax and key is the name for that value. |
||
| 132 | * $errorName The name of the category to use in case of an error. |
||
| 133 | * |
||
| 134 | * Result: An array with entries, each of which is an array with the following fields: |
||
| 135 | * 'number1' The first number of the range or the number specified |
||
| 136 | * 'number2' The second number of the range if a range is specified |
||
| 137 | * 'hasInterval' TRUE if a range is specified. FALSE otherwise |
||
| 138 | * 'interval' The interval if a range is specified. |
||
| 139 | */ |
||
| 140 | final private function cronInterpret($specification, $rangeMin, $rangeMax, $namedItems, $errorName) |
||
| 141 | { |
||
| 142 | if ((!is_string($specification)) && (!(is_int($specification)))) { |
||
| 143 | throw new \Exception('Invalid specification.'); |
||
| 144 | } |
||
| 145 | // Multiple values, separated by comma |
||
| 146 | $specs = []; |
||
| 147 | $specs['rangeMin'] = $rangeMin; |
||
| 148 | $specs['rangeMax'] = $rangeMax; |
||
| 149 | $specs['elements'] = []; |
||
| 150 | $arrSegments = explode(',', $specification); |
||
| 151 | foreach ($arrSegments as $segment) { |
||
| 152 | $hasRange = (($posRange = strpos($segment, '-')) !== false); |
||
| 153 | $hasInterval = (($posIncrement = strpos($segment, '/')) !== false); |
||
| 154 | ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// |
||
| 155 | // Check: Increment without range is invalid |
||
| 156 | //if(!$hasRange && $hasInterval) throw new \Exception("Invalid Range ($errorName)."); |
||
| 157 | // Check: Increment must be final specification |
||
| 158 | if ($hasRange && $hasInterval) { |
||
| 159 | if ($posIncrement < $posRange) { |
||
| 160 | throw new \Exception("Invalid order ($errorName)."); |
||
| 161 | } |
||
| 162 | } |
||
| 163 | // GetSegments |
||
| 164 | $segmentNumber1 = $segment; |
||
| 165 | $segmentNumber2 = ''; |
||
| 166 | $segmentIncrement = ''; |
||
| 167 | $intIncrement = 1; |
||
| 168 | if ($hasInterval) { |
||
| 169 | $segmentNumber1 = substr($segment, 0, $posIncrement); |
||
| 170 | $segmentIncrement = substr($segment, $posIncrement + 1); |
||
| 171 | } |
||
| 172 | if ($hasRange) { |
||
| 173 | $segmentNumber2 = substr($segmentNumber1, $posRange + 1); |
||
| 174 | $segmentNumber1 = substr($segmentNumber1, 0, $posRange); |
||
| 175 | } |
||
| 176 | // Get and validate first value in range |
||
| 177 | if ($segmentNumber1 == '*') { |
||
| 178 | $intNumber1 = $rangeMin; |
||
| 179 | $intNumber2 = $rangeMax; |
||
| 180 | $hasRange = true; |
||
| 181 | } else { |
||
| 182 | if (array_key_exists(strtoupper($segmentNumber1), $namedItems)) { |
||
| 183 | $segmentNumber1 = $namedItems[strtoupper($segmentNumber1)]; |
||
| 184 | } |
||
| 185 | if (((string) ($intNumber1 = (int) $segmentNumber1)) != $segmentNumber1) { |
||
| 186 | throw new \Exception("Invalid symbol ($errorName)."); |
||
| 187 | } |
||
| 188 | if (($intNumber1 < $rangeMin) || ($intNumber1 > $rangeMax)) { |
||
| 189 | throw new \Exception("Out of bounds ($errorName)."); |
||
| 190 | } |
||
| 191 | // Get and validate second value in range |
||
| 192 | if ($hasRange) { |
||
| 193 | if (array_key_exists(strtoupper($segmentNumber2), $namedItems)) { |
||
| 194 | $segmentNumber2 = $namedItems[strtoupper($segmentNumber2)]; |
||
| 195 | } |
||
| 196 | if (((string) ($intNumber2 = (int) $segmentNumber2)) != $segmentNumber2) { |
||
| 197 | throw new \Exception("Invalid symbol ($errorName)."); |
||
| 198 | } |
||
| 199 | if (($intNumber2 < $rangeMin) || ($intNumber2 > $rangeMax)) { |
||
| 200 | throw new \Exception("Out of bounds ($errorName)."); |
||
| 201 | } |
||
| 202 | if ($intNumber1 > $intNumber2) { |
||
| 203 | throw new \Exception("Invalid range ($errorName)."); |
||
| 204 | } |
||
| 205 | } |
||
| 206 | } |
||
| 207 | // Get and validate increment |
||
| 208 | if ($hasInterval) { |
||
| 209 | if (($intIncrement = (int) $segmentIncrement) != $segmentIncrement) { |
||
| 210 | throw new \Exception("Invalid symbol ($errorName)."); |
||
| 211 | } |
||
| 212 | if ($intIncrement < 1) { |
||
| 213 | throw new \Exception("Out of bounds ($errorName)."); |
||
| 214 | } |
||
| 215 | } |
||
| 216 | // Apply range and increment |
||
| 217 | $elem = []; |
||
| 218 | $elem['number1'] = $intNumber1; |
||
| 219 | $elem['hasInterval'] = $hasRange; |
||
| 220 | if ($hasRange) { |
||
| 221 | $elem['number2'] = $intNumber2; |
||
| 222 | $elem['interval'] = $intIncrement; |
||
| 223 | } |
||
| 224 | $specs['elements'][] = $elem; |
||
| 225 | } |
||
| 226 | |||
| 227 | return $specs; |
||
| 228 | } |
||
| 229 | |||
| 230 | // |
||
| 231 | // Function: cronCreateItems |
||
| 232 | // |
||
| 233 | // Description: Uses the interpreted cron specification of a single item from a cron specification to create an array with keys that match the |
||
| 234 | // selected items. |
||
| 235 | // |
||
| 236 | // Parameters: $cronInterpreted The interpreted specification |
||
| 237 | // |
||
| 238 | // Result: An array where each key identifies a matching entry. E.g. the cron specification */10 for minutes will yield an array |
||
| 239 | // [0] => 1 |
||
| 240 | // [10] => 1 |
||
| 241 | // [20] => 1 |
||
| 242 | // [30] => 1 |
||
| 243 | // [40] => 1 |
||
| 244 | // [50] => 1 |
||
| 245 | // |
||
| 246 | final private function cronCreateItems($cronInterpreted) |
||
| 247 | { |
||
| 248 | $items = []; |
||
| 249 | foreach ($cronInterpreted['elements'] as $elem) { |
||
| 250 | if (!$elem['hasInterval']) { |
||
| 251 | $items[$elem['number1']] = true; |
||
| 252 | } else { |
||
| 253 | for ($number = $elem['number1']; $number <= $elem['number2']; $number += $elem['interval']) { |
||
| 254 | $items[$number] = true; |
||
| 255 | } |
||
| 256 | } |
||
| 257 | } |
||
| 258 | ksort($items); |
||
| 259 | |||
| 260 | return $items; |
||
| 261 | } |
||
| 262 | |||
| 263 | // |
||
| 264 | // Function: dtFromParameters |
||
| 265 | // |
||
| 266 | // Description: Transforms a flexible parameter passing of a datetime specification into an internally used array. |
||
| 267 | // |
||
| 268 | // Parameters: $time If a string interpreted as a datetime string in the YYYY-MM-DD HH:II format and other parameters ignored. |
||
| 269 | // If an array $minute, $hour, $day, $month and $year are passed as keys 0-4 and other parameters ignored. |
||
| 270 | // If a string, interpreted as unix time. |
||
| 271 | // If omitted or specified FALSE, defaults to the current time. |
||
| 272 | // |
||
| 273 | // Result: An array with indices 0-4 holding the actual interpreted values for $minute, $hour, $day, $month and $year. |
||
| 274 | // |
||
| 275 | final private function dtFromParameters($time = false) |
||
| 276 | { |
||
| 277 | if ($time === false) { |
||
| 278 | $arrTime = getdate(); |
||
| 279 | |||
| 280 | return [$arrTime['minutes'], $arrTime['hours'], $arrTime['mday'], $arrTime['mon'], $arrTime['year']]; |
||
| 281 | } elseif (is_array($time)) { |
||
| 282 | return $time; |
||
| 283 | } elseif (is_string($time)) { |
||
| 284 | $arrTime = getdate(strtotime($time)); |
||
| 285 | |||
| 286 | return [$arrTime['minutes'], $arrTime['hours'], $arrTime['mday'], $arrTime['mon'], $arrTime['year']]; |
||
| 287 | } elseif (is_int($time)) { |
||
| 288 | $arrTime = getdate($time); |
||
| 289 | |||
| 290 | return [$arrTime['minutes'], $arrTime['hours'], $arrTime['mday'], $arrTime['mon'], $arrTime['year']]; |
||
| 291 | } |
||
| 292 | } |
||
| 293 | |||
| 294 | final private function dtAsString($arrDt) |
||
| 295 | { |
||
| 296 | if ($arrDt === false) { |
||
| 297 | return false; |
||
| 298 | } |
||
| 299 | |||
| 300 | return $arrDt[4].'-'.(strlen($arrDt[3]) == 1 ? '0' : '').$arrDt[3].'-'.(strlen($arrDt[2]) == 1 ? '0' : '').$arrDt[2].' '.(strlen($arrDt[1]) == 1 ? '0' : '').$arrDt[1].':'.(strlen($arrDt[0]) == 1 ? '0' : '').$arrDt[0].':00'; |
||
| 301 | } |
||
| 302 | |||
| 303 | // |
||
| 304 | // Function: match |
||
| 305 | // |
||
| 306 | // Description: Returns TRUE if the specified date and time corresponds to a scheduled point in time. FALSE otherwise. |
||
| 307 | // |
||
| 308 | // Parameters: $time If a string interpreted as a datetime string in the YYYY-MM-DD HH:II format and other parameters ignored. |
||
| 309 | // If an array $minute, $hour, $day, $month and $year are passed as keys 0-4 and other parameters ignored. |
||
| 310 | // If a string, interpreted as unix time. |
||
| 311 | // If omitted or specified FALSE, defaults to the current time. |
||
| 312 | // |
||
| 313 | // Result: TRUE if the schedule matches the specified datetime. FALSE otherwise. |
||
| 314 | // |
||
| 315 | final public function match($time = false) |
||
| 316 | { |
||
| 317 | // Convert parameters to array datetime |
||
| 318 | $arrDT = $this->dtFromParameters($time); |
||
| 319 | // Verify match |
||
| 320 | // Years |
||
| 321 | if (!array_key_exists($arrDT[4], $this->_years)) { |
||
| 322 | return false; |
||
| 323 | } |
||
| 324 | // Day of week |
||
| 325 | if (!array_key_exists(date('w', strtotime($arrDT[4].'-'.$arrDT[3].'-'.$arrDT[2])), $this->_daysOfWeek)) { |
||
| 326 | return false; |
||
| 327 | } |
||
| 328 | // Month |
||
| 329 | if (!array_key_exists($arrDT[3], $this->_months)) { |
||
| 330 | return false; |
||
| 331 | } |
||
| 332 | // Day of month |
||
| 333 | if (!array_key_exists($arrDT[2], $this->_daysOfMonth)) { |
||
| 334 | return false; |
||
| 335 | } |
||
| 336 | // Hours |
||
| 337 | if (!array_key_exists($arrDT[1], $this->_hours)) { |
||
| 338 | return false; |
||
| 339 | } |
||
| 340 | // Minutes |
||
| 341 | if (!array_key_exists($arrDT[0], $this->_minutes)) { |
||
| 342 | return false; |
||
| 343 | } |
||
| 344 | |||
| 345 | return true; |
||
| 346 | } |
||
| 347 | |||
| 348 | // |
||
| 349 | // Function: next |
||
| 350 | // |
||
| 351 | // Description: Acquires the first scheduled datetime beyond the provided one. |
||
| 352 | // |
||
| 353 | // Parameters: $time If a string interpreted as a datetime string in the YYYY-MM-DD HH:II format and other parameters ignored. |
||
| 354 | // If an array $minute, $hour, $day, $month and $year are passed as keys 0-4 and other parameters ignored. |
||
| 355 | // If a string, interpreted as unix time. |
||
| 356 | // If omitted or specified FALSE, defaults to the current time. |
||
| 357 | // |
||
| 358 | // Result: An array with the following keys: |
||
| 359 | // 0 Next scheduled minute |
||
| 360 | // 1 Next scheduled hour |
||
| 361 | // 2 Next scheduled date |
||
| 362 | // 3 Next scheduled month |
||
| 363 | // 4 Next scheduled year |
||
| 364 | // |
||
| 365 | final public function next($time = false) |
||
| 366 | { |
||
| 367 | // Convert parameters to array datetime |
||
| 368 | $arrDT = $this->dtFromParameters($time); |
||
| 369 | while (1) { |
||
| 370 | // Verify the current date is in range. If not, move into range and consider this the next position |
||
| 371 | if (!array_key_exists($arrDT[4], $this->_years)) { |
||
| 372 | if (($arrDT[4] = $this->getEarliestItem($this->_years, $arrDT[4], false)) === false) { |
||
| 373 | return false; |
||
| 374 | } |
||
| 375 | $arrDT[3] = $this->getEarliestItem($this->_months); |
||
| 376 | $arrDT[2] = $this->getEarliestItem($this->_daysOfMonth); |
||
| 377 | $arrDT[1] = $this->getEarliestItem($this->_hours); |
||
| 378 | $arrDT[0] = $this->getEarliestItem($this->_minutes); |
||
| 379 | break; |
||
| 380 | } elseif (!array_key_exists($arrDT[3], $this->_months)) { |
||
| 381 | $arrDT[3] = $this->getEarliestItem($this->_months, $arrDT[3]); |
||
| 382 | $arrDT[2] = $this->getEarliestItem($this->_daysOfMonth); |
||
| 383 | $arrDT[1] = $this->getEarliestItem($this->_hours); |
||
| 384 | $arrDT[0] = $this->getEarliestItem($this->_minutes); |
||
| 385 | break; |
||
| 386 | } elseif (!array_key_exists($arrDT[2], $this->_daysOfMonth)) { |
||
| 387 | $arrDT[2] = $this->getEarliestItem($this->_daysOfMonth, $arrDT[2]); |
||
| 388 | $arrDT[1] = $this->getEarliestItem($this->_hours); |
||
| 389 | $arrDT[0] = $this->getEarliestItem($this->_minutes); |
||
| 390 | break; |
||
| 391 | } elseif (!array_key_exists($arrDT[1], $this->_hours)) { |
||
| 392 | $arrDT[1] = $this->getEarliestItem($this->_hours, $arrDT[1]); |
||
| 393 | $arrDT[0] = $this->getEarliestItem($this->_minutes); |
||
| 394 | break; |
||
| 395 | } elseif (!array_key_exists($arrDT[1], $this->_hours)) { |
||
| 396 | $arrDT[0] = $this->getEarliestItem($this->_minutes, $arrDT[0]); |
||
| 397 | break; |
||
| 398 | } |
||
| 399 | // Advance minute, hour, date, month and year while overflowing. |
||
| 400 | $daysInThisMonth = date('t', strtotime($arrDT[4].'-'.$arrDT[3])); |
||
| 401 | if ($this->advanceItem($this->_minutes, 0, 59, $arrDT[0])) { |
||
| 402 | if ($this->advanceItem($this->_hours, 0, 23, $arrDT[1])) { |
||
| 403 | if ($this->advanceItem($this->_daysOfMonth, 0, $daysInThisMonth, $arrDT[2])) { |
||
| 404 | if ($this->advanceItem($this->_months, 1, 12, $arrDT[3])) { |
||
| 405 | if ($this->advanceItem($this->_years, $this->RANGE_YEARS_MIN, $this->RANGE_YEARS_MAX, $arrDT[4])) { |
||
| 406 | return false; |
||
| 407 | } |
||
| 408 | } |
||
| 409 | } |
||
| 410 | } |
||
| 411 | } |
||
| 412 | break; |
||
| 413 | } |
||
| 414 | // If Datetime now points to a day that is schedule then return. |
||
| 415 | $dayOfWeek = date('w', strtotime($this->dtAsString($arrDT))); |
||
| 416 | if (array_key_exists($dayOfWeek, $this->_daysOfWeek)) { |
||
| 417 | return $arrDT; |
||
| 418 | } |
||
| 419 | // Otherwise move to next scheduled date |
||
| 420 | return $this->next($arrDT); |
||
| 421 | } |
||
| 422 | |||
| 423 | final public function nextAsString($time = false) |
||
| 424 | { |
||
| 425 | return $this->dtAsString($this->next($time)); |
||
| 426 | } |
||
| 427 | |||
| 428 | final public function nextAsTime($time = false) |
||
| 429 | { |
||
| 430 | return strtotime($this->dtAsString($this->next($time))); |
||
| 431 | } |
||
| 432 | |||
| 433 | // |
||
| 434 | // Function: advanceItem |
||
| 435 | // |
||
| 436 | // Description: Advances the current item to the next one (the next minute, the next hour, etc.). |
||
| 437 | // |
||
| 438 | // Parameters: $arrItems A reference to the collection in which to advance. |
||
| 439 | // $rangeMin The lowest possible value for $current. |
||
| 440 | // $rangeMax The highest possible value for $current |
||
| 441 | // $current The index that is being incremented. |
||
| 442 | // |
||
| 443 | // Result: FALSE if current did not overflow (reset back to the earliest possible value). TRUE if it did. |
||
| 444 | // |
||
| 445 | final private function advanceItem($arrItems, $rangeMin, $rangeMax, &$current) |
||
| 446 | { |
||
| 447 | // Advance pointer |
||
| 448 | $current++; |
||
| 449 | // If still before start, move to earliest |
||
| 450 | if ($current < $rangeMin) { |
||
| 451 | $current = $this->getEarliestItem($arrItems); |
||
| 452 | } |
||
| 453 | // Parse items until found or overflow |
||
| 454 | for (; $current <= $rangeMax; $current++) { |
||
| 455 | if (array_key_exists($current, $arrItems)) { |
||
| 456 | return false; |
||
| 457 | } |
||
| 458 | } // We did not overflow |
||
| 459 | // Or overflow |
||
| 460 | $current = $this->getEarliestItem($arrItems); |
||
| 461 | |||
| 462 | return true; |
||
| 463 | } |
||
| 464 | |||
| 465 | // |
||
| 466 | // Function: getEarliestItem |
||
| 467 | // |
||
| 468 | // Description: Retrieves the earliest item in a collection, e.g. the earliest minute or the earliest month. |
||
| 469 | // |
||
| 470 | // Parameters: $arrItems A reference to the collection in which to search. |
||
| 471 | // $afterItem The highest index that is to be skipped. |
||
| 472 | // |
||
| 473 | final private function getEarliestItem($arrItems, $afterItem = false, $allowOverflow = true) |
||
| 474 | { |
||
| 475 | // If no filter is specified, return the earliest listed item. |
||
| 476 | if ($afterItem === false) { |
||
| 477 | reset($arrItems); |
||
| 478 | |||
| 479 | return key($arrItems); |
||
| 480 | } |
||
| 481 | // Or parse until we passed $afterItem |
||
| 482 | foreach ($arrItems as $key => $value) { |
||
| 483 | if ($key > $afterItem) { |
||
| 484 | return $key; |
||
| 485 | } |
||
| 486 | } |
||
| 487 | // If still nothing found, we may have exhausted our options. |
||
| 488 | if (!$allowOverflow) { |
||
| 489 | return false; |
||
| 490 | } |
||
| 491 | reset($arrItems); |
||
| 492 | |||
| 493 | return key($arrItems); |
||
| 494 | } |
||
| 495 | |||
| 496 | // |
||
| 497 | // Function: previous |
||
| 498 | // |
||
| 499 | // Description: Acquires the first scheduled datetime before the provided one. |
||
| 500 | // |
||
| 501 | // Parameters: $time If a string interpreted as a datetime string in the YYYY-MM-DD HH:II format and other parameters ignored. |
||
| 502 | // If an array $minute, $hour, $day, $month and $year are passed as keys 0-4 and other parameters ignored. |
||
| 503 | // If a string, interpreted as unix time. |
||
| 504 | // If omitted or specified FALSE, defaults to the current time. |
||
| 505 | // |
||
| 506 | // Result: An array with the following keys: |
||
| 507 | // 0 Previous scheduled minute |
||
| 508 | // 1 Previous scheduled hour |
||
| 509 | // 2 Previous scheduled date |
||
| 510 | // 3 Previous scheduled month |
||
| 511 | // 4 Previous scheduled year |
||
| 512 | // |
||
| 513 | final public function previous($time = false) |
||
| 514 | { |
||
| 515 | // Convert parameters to array datetime |
||
| 516 | $arrDT = $this->dtFromParameters($time); |
||
| 517 | while (1) { |
||
| 518 | // Verify the current date is in range. If not, move into range and consider this the previous position |
||
| 519 | if (!array_key_exists($arrDT[4], $this->_years)) { |
||
| 520 | if (($arrDT[4] = $this->getLatestItem($this->_years, $arrDT[4], false)) === false) { |
||
| 521 | return false; |
||
| 522 | } |
||
| 523 | $arrDT[3] = $this->getLatestItem($this->_months); |
||
| 524 | $arrDT[2] = $this->getLatestItem($this->_daysOfMonth); |
||
| 525 | $arrDT[1] = $this->getLatestItem($this->_hours); |
||
| 526 | $arrDT[0] = $this->getLatestItem($this->_minutes); |
||
| 527 | break; |
||
| 528 | } elseif (!array_key_exists($arrDT[3], $this->_months)) { |
||
| 529 | $arrDT[3] = $this->getLatestItem($this->_months, $arrDT[3]); |
||
| 530 | $arrDT[2] = $this->getLatestItem($this->_daysOfMonth); |
||
| 531 | $arrDT[1] = $this->getLatestItem($this->_hours); |
||
| 532 | $arrDT[0] = $this->getLatestItem($this->_minutes); |
||
| 533 | break; |
||
| 534 | } elseif (!array_key_exists($arrDT[2], $this->_daysOfMonth)) { |
||
| 535 | $arrDT[2] = $this->getLatestItem($this->_daysOfMonth, $arrDT[2]); |
||
| 536 | $arrDT[1] = $this->getLatestItem($this->_hours); |
||
| 537 | $arrDT[0] = $this->getLatestItem($this->_minutes); |
||
| 538 | break; |
||
| 539 | } elseif (!array_key_exists($arrDT[1], $this->_hours)) { |
||
| 540 | $arrDT[1] = $this->getLatestItem($this->_hours, $arrDT[1]); |
||
| 541 | $arrDT[0] = $this->getLatestItem($this->_minutes); |
||
| 542 | break; |
||
| 543 | } elseif (!array_key_exists($arrDT[1], $this->_hours)) { |
||
| 544 | $arrDT[0] = $this->getLatestItem($this->_minutes, $arrDT[0]); |
||
| 545 | break; |
||
| 546 | } |
||
| 547 | // Recede minute, hour, date, month and year while overflowing. |
||
| 548 | $daysInPreviousMonth = date('t', strtotime('-1 month', strtotime($arrDT[4].'-'.$arrDT[3]))); |
||
| 549 | if ($this->recedeItem($this->_minutes, 0, 59, $arrDT[0])) { |
||
| 550 | if ($this->recedeItem($this->_hours, 0, 23, $arrDT[1])) { |
||
| 551 | if ($this->recedeItem($this->_daysOfMonth, 0, $daysInPreviousMonth, $arrDT[2])) { |
||
| 552 | if ($this->recedeItem($this->_months, 1, 12, $arrDT[3])) { |
||
| 553 | if ($this->recedeItem($this->_years, $this->RANGE_YEARS_MIN, $this->RANGE_YEARS_MAX, $arrDT[4])) { |
||
| 554 | return false; |
||
| 555 | } |
||
| 556 | } |
||
| 557 | } |
||
| 558 | } |
||
| 559 | } |
||
| 560 | break; |
||
| 561 | } |
||
| 562 | // If Datetime now points to a day that is schedule then return. |
||
| 563 | $dayOfWeek = date('w', strtotime($this->dtAsString($arrDT))); |
||
| 564 | if (array_key_exists($dayOfWeek, $this->_daysOfWeek)) { |
||
| 565 | return $arrDT; |
||
| 566 | } |
||
| 567 | // Otherwise move to next scheduled date |
||
| 568 | return $this->previous($arrDT); |
||
| 569 | } |
||
| 570 | |||
| 571 | final public function previousAsString($time = false) |
||
| 572 | { |
||
| 573 | return $this->dtAsString($this->previous($time)); |
||
| 574 | } |
||
| 575 | |||
| 576 | final public function previousAsTime($time = false) |
||
| 579 | } |
||
| 580 | |||
| 581 | // |
||
| 582 | // Function: recedeItem |
||
| 583 | // |
||
| 584 | // Description: Recedes the current item to the previous one (the previous minute, the previous hour, etc.). |
||
| 585 | // |
||
| 586 | // Parameters: $arrItems A reference to the collection in which to recede. |
||
| 587 | // $rangeMin The lowest possible value for $current. |
||
| 588 | // $rangeMax The highest possible value for $current |
||
| 589 | // $current The index that is being decremented. |
||
| 590 | // |
||
| 591 | // Result: FALSE if current did not overflow (reset back to the highest possible value). TRUE if it did. |
||
| 592 | // |
||
| 593 | final private function recedeItem($arrItems, $rangeMin, $rangeMax, &$current) |
||
| 594 | { |
||
| 595 | // Recede pointer |
||
| 596 | $current--; |
||
| 597 | // If still above highest, move to highest |
||
| 598 | if ($current > $rangeMax) { |
||
| 599 | $current = $this->getLatestItem($arrItems, $rangeMax + 1); |
||
| 600 | } |
||
| 601 | // Parse items until found or overflow |
||
| 602 | for (; $current >= $rangeMin; $current--) { |
||
| 603 | if (array_key_exists($current, $arrItems)) { |
||
| 604 | return false; |
||
| 605 | } |
||
| 606 | } // We did not overflow |
||
| 607 | // Or overflow |
||
| 608 | $current = $this->getLatestItem($arrItems, $rangeMax + 1); |
||
| 609 | |||
| 610 | return true; |
||
| 611 | } |
||
| 612 | |||
| 613 | // |
||
| 614 | // Function: getLatestItem |
||
| 615 | // |
||
| 616 | // Description: Retrieves the latest item in a collection, e.g. the latest minute or the latest month. |
||
| 617 | // |
||
| 618 | // Parameters: $arrItems A reference to the collection in which to search. |
||
| 619 | // $beforeItem The lowest index that is to be skipped. |
||
| 620 | // |
||
| 621 | final private function getLatestItem($arrItems, $beforeItem = false, $allowOverflow = true) |
||
| 622 | { |
||
| 623 | // If no filter is specified, return the latestlisted item. |
||
| 624 | if ($beforeItem === false) { |
||
| 625 | end($arrItems); |
||
| 626 | |||
| 627 | return key($arrItems); |
||
| 628 | } |
||
| 629 | // Or parse until we passed $beforeItem |
||
| 630 | end($arrItems); |
||
| 631 | do { |
||
| 632 | if (($key = key($arrItems)) < $beforeItem) { |
||
| 633 | return $key; |
||
| 634 | } |
||
| 635 | } while (prev($arrItems)); |
||
| 636 | // If still nothing found, we may have exhausted our options. |
||
| 637 | if (!$allowOverflow) { |
||
| 638 | return false; |
||
| 639 | } |
||
| 640 | end($arrItems); |
||
| 641 | |||
| 642 | return key($arrItems); |
||
| 643 | } |
||
| 644 | |||
| 645 | // |
||
| 646 | // Function: |
||
| 647 | // |
||
| 648 | // Description: |
||
| 649 | // |
||
| 650 | // Parameters: |
||
| 651 | // |
||
| 652 | // Result: |
||
| 653 | // |
||
| 654 | final private function getClass($spec) |
||
| 655 | { |
||
| 656 | if (!$this->classIsSpecified($spec)) { |
||
| 657 | return '0'; |
||
| 658 | } |
||
| 659 | if ($this->classIsSingleFixed($spec)) { |
||
| 660 | return '1'; |
||
| 661 | } |
||
| 662 | |||
| 663 | return '2'; |
||
| 664 | } |
||
| 665 | |||
| 666 | // |
||
| 667 | // Function: |
||
| 668 | // |
||
| 669 | // Description: Returns TRUE if the Cron Specification is specified. FALSE otherwise. This is true if the specification has more than one entry |
||
| 670 | // or is anything than the entire approved range ("*"). |
||
| 671 | // |
||
| 672 | // Parameters: |
||
| 673 | // |
||
| 674 | // Result: |
||
| 675 | // |
||
| 676 | final private function classIsSpecified($spec) |
||
| 677 | { |
||
| 678 | if ($spec['elements'][0]['hasInterval'] == false) { |
||
| 679 | return true; |
||
| 680 | } |
||
| 681 | if ($spec['elements'][0]['number1'] != $spec['rangeMin']) { |
||
| 682 | return true; |
||
| 683 | } |
||
| 684 | if ($spec['elements'][0]['number2'] != $spec['rangeMax']) { |
||
| 685 | return true; |
||
| 686 | } |
||
| 687 | if ($spec['elements'][0]['interval'] != 1) { |
||
| 688 | return true; |
||
| 689 | } |
||
| 690 | |||
| 691 | return false; |
||
| 692 | } |
||
| 693 | |||
| 694 | // |
||
| 695 | // Function: |
||
| 696 | // |
||
| 697 | // Description: Returns TRUE if the Cron Specification is specified as a single value. FALSE otherwise. This is true only if there is only |
||
| 698 | // one entry and the entry is only a single number (e.g. "10") |
||
| 699 | // |
||
| 700 | // Parameters: |
||
| 701 | // |
||
| 702 | // Result: |
||
| 703 | // |
||
| 704 | final private function classIsSingleFixed($spec) |
||
| 707 | } |
||
| 708 | |||
| 709 | final private function initLang($language = 'en') |
||
| 710 | { |
||
| 711 | switch ($language) { |
||
| 712 | case 'en': |
||
| 713 | $this->_lang['elemMin: at_the_hour'] = 'at the hour'; |
||
| 714 | $this->_lang['elemMin: after_the_hour_every_X_minute'] = 'every minute'; |
||
| 715 | $this->_lang['elemMin: after_the_hour_every_X_minute_plural'] = 'every @1 minutes'; |
||
| 716 | $this->_lang['elemMin: every_consecutive_minute'] = 'every consecutive minute'; |
||
| 717 | $this->_lang['elemMin: every_consecutive_minute_plural'] = 'every consecutive @1 minutes'; |
||
| 718 | $this->_lang['elemMin: every_minute'] = 'every minute'; |
||
| 719 | $this->_lang['elemMin: between_X_and_Y'] = 'from the @1 to the @2'; |
||
| 720 | $this->_lang['elemMin: at_X:Y'] = 'At @1:@2'; |
||
| 721 | $this->_lang['elemHour: past_X:00'] = 'past @1:00'; |
||
| 722 | $this->_lang['elemHour: between_X:00_and_Y:59'] = 'between @1:00 and @2:59'; |
||
| 723 | $this->_lang['elemHour: in_the_60_minutes_past_'] = 'in the 60 minutes past every consecutive hour'; |
||
| 724 | $this->_lang['elemHour: in_the_60_minutes_past__plural'] = 'in the 60 minutes past every consecutive @1 hours'; |
||
| 725 | $this->_lang['elemHour: past_every_consecutive_'] = 'past every consecutive hour'; |
||
| 726 | $this->_lang['elemHour: past_every_consecutive__plural'] = 'past every consecutive @1 hours'; |
||
| 727 | $this->_lang['elemHour: past_every_hour'] = 'past every hour'; |
||
| 728 | $this->_lang['elemDOM: the_X'] = 'the @1'; |
||
| 729 | $this->_lang['elemDOM: every_consecutive_day'] = 'every consecutive day'; |
||
| 730 | $this->_lang['elemDOM: every_consecutive_day_plural'] = 'every consecutive @1 days'; |
||
| 731 | $this->_lang['elemDOM: on_every_day'] = 'on every day'; |
||
| 732 | $this->_lang['elemDOM: between_the_Xth_and_Yth'] = 'between the @1 and the @2'; |
||
| 733 | $this->_lang['elemDOM: on_the_X'] = 'on the @1'; |
||
| 734 | $this->_lang['elemDOM: on_X'] = 'on @1'; |
||
| 735 | $this->_lang['elemMonth: every_X'] = 'every @1'; |
||
| 736 | $this->_lang['elemMonth: every_consecutive_month'] = 'every consecutive month'; |
||
| 737 | $this->_lang['elemMonth: every_consecutive_month_plural'] = 'every consecutive @1 months'; |
||
| 738 | $this->_lang['elemMonth: between_X_and_Y'] = 'from @1 to @2'; |
||
| 739 | $this->_lang['elemMonth: of_every_month'] = 'of every month'; |
||
| 740 | $this->_lang['elemMonth: during_every_X'] = 'during every @1'; |
||
| 741 | $this->_lang['elemMonth: during_X'] = 'during @1'; |
||
| 742 | $this->_lang['elemYear: in_X'] = 'in @1'; |
||
| 743 | $this->_lang['elemYear: every_consecutive_year'] = 'every consecutive year'; |
||
| 744 | $this->_lang['elemYear: every_consecutive_year_plural'] = 'every consecutive @1 years'; |
||
| 745 | $this->_lang['elemYear: from_X_through_Y'] = 'from @1 through @2'; |
||
| 746 | $this->_lang['elemDOW: on_every_day'] = 'on every day'; |
||
| 747 | $this->_lang['elemDOW: on_X'] = 'on @1'; |
||
| 748 | $this->_lang['elemDOW: but_only_on_X'] = 'but only if the event takes place on @1'; |
||
| 749 | $this->_lang['separator_and'] = 'and'; |
||
| 750 | $this->_lang['separator_or'] = 'or'; |
||
| 751 | $this->_lang['day: 0_plural'] = 'Sundays'; |
||
| 752 | $this->_lang['day: 1_plural'] = 'Mondays'; |
||
| 753 | $this->_lang['day: 2_plural'] = 'Tuesdays'; |
||
| 754 | $this->_lang['day: 3_plural'] = 'Wednesdays'; |
||
| 755 | $this->_lang['day: 4_plural'] = 'Thursdays'; |
||
| 756 | $this->_lang['day: 5_plural'] = 'Fridays'; |
||
| 757 | $this->_lang['day: 6_plural'] = 'Saturdays'; |
||
| 758 | $this->_lang['month: 1'] = 'January'; |
||
| 759 | $this->_lang['month: 2'] = 'February'; |
||
| 760 | $this->_lang['month: 3'] = 'March'; |
||
| 761 | $this->_lang['month: 4'] = 'April'; |
||
| 762 | $this->_lang['month: 5'] = 'May'; |
||
| 763 | $this->_lang['month: 6'] = 'June'; |
||
| 764 | $this->_lang['month: 7'] = 'July'; |
||
| 765 | $this->_lang['month: 8'] = 'Augustus'; |
||
| 766 | $this->_lang['month: 9'] = 'September'; |
||
| 767 | $this->_lang['month: 10'] = 'October'; |
||
| 768 | $this->_lang['month: 11'] = 'November'; |
||
| 769 | $this->_lang['month: 12'] = 'December'; |
||
| 770 | $this->_lang['ordinal: 1'] = '1st'; |
||
| 771 | $this->_lang['ordinal: 2'] = '2nd'; |
||
| 772 | $this->_lang['ordinal: 3'] = '3rd'; |
||
| 773 | $this->_lang['ordinal: 4'] = '4th'; |
||
| 774 | $this->_lang['ordinal: 5'] = '5th'; |
||
| 775 | $this->_lang['ordinal: 6'] = '6th'; |
||
| 776 | $this->_lang['ordinal: 7'] = '7th'; |
||
| 777 | $this->_lang['ordinal: 8'] = '8th'; |
||
| 778 | $this->_lang['ordinal: 9'] = '9th'; |
||
| 779 | $this->_lang['ordinal: 10'] = '10th'; |
||
| 780 | $this->_lang['ordinal: 11'] = '11th'; |
||
| 781 | $this->_lang['ordinal: 12'] = '12th'; |
||
| 782 | $this->_lang['ordinal: 13'] = '13th'; |
||
| 783 | $this->_lang['ordinal: 14'] = '14th'; |
||
| 784 | $this->_lang['ordinal: 15'] = '15th'; |
||
| 785 | $this->_lang['ordinal: 16'] = '16th'; |
||
| 786 | $this->_lang['ordinal: 17'] = '17th'; |
||
| 787 | $this->_lang['ordinal: 18'] = '18th'; |
||
| 788 | $this->_lang['ordinal: 19'] = '19th'; |
||
| 789 | $this->_lang['ordinal: 20'] = '20th'; |
||
| 790 | $this->_lang['ordinal: 21'] = '21st'; |
||
| 791 | $this->_lang['ordinal: 22'] = '22nd'; |
||
| 792 | $this->_lang['ordinal: 23'] = '23rd'; |
||
| 793 | $this->_lang['ordinal: 24'] = '24th'; |
||
| 794 | $this->_lang['ordinal: 25'] = '25th'; |
||
| 795 | $this->_lang['ordinal: 26'] = '26th'; |
||
| 796 | $this->_lang['ordinal: 27'] = '27th'; |
||
| 797 | $this->_lang['ordinal: 28'] = '28th'; |
||
| 798 | $this->_lang['ordinal: 29'] = '29th'; |
||
| 799 | $this->_lang['ordinal: 30'] = '30th'; |
||
| 800 | $this->_lang['ordinal: 31'] = '31st'; |
||
| 801 | $this->_lang['ordinal: 32'] = '32nd'; |
||
| 802 | $this->_lang['ordinal: 33'] = '33rd'; |
||
| 803 | $this->_lang['ordinal: 34'] = '34th'; |
||
| 804 | $this->_lang['ordinal: 35'] = '35th'; |
||
| 805 | $this->_lang['ordinal: 36'] = '36th'; |
||
| 806 | $this->_lang['ordinal: 37'] = '37th'; |
||
| 807 | $this->_lang['ordinal: 38'] = '38th'; |
||
| 808 | $this->_lang['ordinal: 39'] = '39th'; |
||
| 809 | $this->_lang['ordinal: 40'] = '40th'; |
||
| 810 | $this->_lang['ordinal: 41'] = '41st'; |
||
| 811 | $this->_lang['ordinal: 42'] = '42nd'; |
||
| 812 | $this->_lang['ordinal: 43'] = '43rd'; |
||
| 813 | $this->_lang['ordinal: 44'] = '44th'; |
||
| 814 | $this->_lang['ordinal: 45'] = '45th'; |
||
| 815 | $this->_lang['ordinal: 46'] = '46th'; |
||
| 816 | $this->_lang['ordinal: 47'] = '47th'; |
||
| 817 | $this->_lang['ordinal: 48'] = '48th'; |
||
| 818 | $this->_lang['ordinal: 49'] = '49th'; |
||
| 819 | $this->_lang['ordinal: 50'] = '50th'; |
||
| 820 | $this->_lang['ordinal: 51'] = '51st'; |
||
| 821 | $this->_lang['ordinal: 52'] = '52nd'; |
||
| 822 | $this->_lang['ordinal: 53'] = '53rd'; |
||
| 823 | $this->_lang['ordinal: 54'] = '54th'; |
||
| 824 | $this->_lang['ordinal: 55'] = '55th'; |
||
| 825 | $this->_lang['ordinal: 56'] = '56th'; |
||
| 826 | $this->_lang['ordinal: 57'] = '57th'; |
||
| 827 | $this->_lang['ordinal: 58'] = '58th'; |
||
| 828 | $this->_lang['ordinal: 59'] = '59th'; |
||
| 829 | break; |
||
| 830 | case 'nl': |
||
| 831 | $this->_lang['elemMin: at_the_hour'] = 'op het hele uur'; |
||
| 832 | $this->_lang['elemMin: after_the_hour_every_X_minute'] = 'elke minuut'; |
||
| 833 | $this->_lang['elemMin: after_the_hour_every_X_minute_plural'] = 'elke @1 minuten'; |
||
| 834 | $this->_lang['elemMin: every_consecutive_minute'] = 'elke opeenvolgende minuut'; |
||
| 835 | $this->_lang['elemMin: every_consecutive_minute_plural'] = 'elke opeenvolgende @1 minuten'; |
||
| 836 | $this->_lang['elemMin: every_minute'] = 'elke minuut'; |
||
| 837 | $this->_lang['elemMin: between_X_and_Y'] = 'van de @1 tot en met de @2'; |
||
| 838 | $this->_lang['elemMin: at_X:Y'] = 'Om @1:@2'; |
||
| 839 | $this->_lang['elemHour: past_X:00'] = 'na @1:00'; |
||
| 840 | $this->_lang['elemHour: between_X:00_and_Y:59'] = 'tussen @1:00 en @2:59'; |
||
| 841 | $this->_lang['elemHour: in_the_60_minutes_past_'] = 'in de 60 minuten na elk opeenvolgend uur'; |
||
| 842 | $this->_lang['elemHour: in_the_60_minutes_past__plural'] = 'in de 60 minuten na elke opeenvolgende @1 uren'; |
||
| 843 | $this->_lang['elemHour: past_every_consecutive_'] = 'na elk opeenvolgend uur'; |
||
| 844 | $this->_lang['elemHour: past_every_consecutive__plural'] = 'na elke opeenvolgende @1 uren'; |
||
| 845 | $this->_lang['elemHour: past_every_hour'] = 'na elk uur'; |
||
| 846 | $this->_lang['elemDOM: the_X'] = 'de @1'; |
||
| 847 | $this->_lang['elemDOM: every_consecutive_day'] = 'elke opeenvolgende dag'; |
||
| 848 | $this->_lang['elemDOM: every_consecutive_day_plural'] = 'elke opeenvolgende @1 dagen'; |
||
| 849 | $this->_lang['elemDOM: on_every_day'] = 'op elke dag'; |
||
| 850 | $this->_lang['elemDOM: between_the_Xth_and_Yth'] = 'tussen de @1 en de @2'; |
||
| 851 | $this->_lang['elemDOM: on_the_X'] = 'op de @1'; |
||
| 852 | $this->_lang['elemDOM: on_X'] = 'op @1'; |
||
| 853 | $this->_lang['elemMonth: every_X'] = 'elke @1'; |
||
| 854 | $this->_lang['elemMonth: every_consecutive_month'] = 'elke opeenvolgende maand'; |
||
| 855 | $this->_lang['elemMonth: every_consecutive_month_plural'] = 'elke opeenvolgende @1 maanden'; |
||
| 856 | $this->_lang['elemMonth: between_X_and_Y'] = 'van @1 tot @2'; |
||
| 857 | $this->_lang['elemMonth: of_every_month'] = 'van elke maand'; |
||
| 858 | $this->_lang['elemMonth: during_every_X'] = 'tijdens elke @1'; |
||
| 859 | $this->_lang['elemMonth: during_X'] = 'tijdens @1'; |
||
| 860 | $this->_lang['elemYear: in_X'] = 'in @1'; |
||
| 861 | $this->_lang['elemYear: every_consecutive_year'] = 'elk opeenvolgend jaar'; |
||
| 862 | $this->_lang['elemYear: every_consecutive_year_plural'] = 'elke opeenvolgende @1 jaren'; |
||
| 863 | $this->_lang['elemYear: from_X_through_Y'] = 'van @1 tot en met @2'; |
||
| 864 | $this->_lang['elemDOW: on_every_day'] = 'op elke dag'; |
||
| 865 | $this->_lang['elemDOW: on_X'] = 'op @1'; |
||
| 866 | $this->_lang['elemDOW: but_only_on_X'] = 'maar alleen als het plaatsvindt op @1'; |
||
| 867 | $this->_lang['separator_and'] = 'en'; |
||
| 868 | $this->_lang['separator_of'] = 'of'; |
||
| 869 | $this->_lang['day: 0_plural'] = 'zondagen'; |
||
| 870 | $this->_lang['day: 1_plural'] = 'maandagen'; |
||
| 871 | $this->_lang['day: 2_plural'] = 'dinsdagen'; |
||
| 872 | $this->_lang['day: 3_plural'] = 'woensdagen'; |
||
| 873 | $this->_lang['day: 4_plural'] = 'donderdagen'; |
||
| 874 | $this->_lang['day: 5_plural'] = 'vrijdagen'; |
||
| 875 | $this->_lang['day: 6_plural'] = 'zaterdagen'; |
||
| 876 | $this->_lang['month: 1'] = 'januari'; |
||
| 877 | $this->_lang['month: 2'] = 'februari'; |
||
| 878 | $this->_lang['month: 3'] = 'maart'; |
||
| 879 | $this->_lang['month: 4'] = 'april'; |
||
| 880 | $this->_lang['month: 5'] = 'mei'; |
||
| 881 | $this->_lang['month: 6'] = 'juni'; |
||
| 882 | $this->_lang['month: 7'] = 'juli'; |
||
| 883 | $this->_lang['month: 8'] = 'augustus'; |
||
| 884 | $this->_lang['month: 9'] = 'september'; |
||
| 885 | $this->_lang['month: 10'] = 'october'; |
||
| 886 | $this->_lang['month: 11'] = 'november'; |
||
| 887 | $this->_lang['month: 12'] = 'december'; |
||
| 888 | $this->_lang['ordinal: 1'] = '1e'; |
||
| 889 | $this->_lang['ordinal: 2'] = '2e'; |
||
| 890 | $this->_lang['ordinal: 3'] = '3e'; |
||
| 891 | $this->_lang['ordinal: 4'] = '4e'; |
||
| 892 | $this->_lang['ordinal: 5'] = '5e'; |
||
| 893 | $this->_lang['ordinal: 6'] = '6e'; |
||
| 894 | $this->_lang['ordinal: 7'] = '7e'; |
||
| 895 | $this->_lang['ordinal: 8'] = '8e'; |
||
| 896 | $this->_lang['ordinal: 9'] = '9e'; |
||
| 897 | $this->_lang['ordinal: 10'] = '10e'; |
||
| 898 | $this->_lang['ordinal: 11'] = '11e'; |
||
| 899 | $this->_lang['ordinal: 12'] = '12e'; |
||
| 900 | $this->_lang['ordinal: 13'] = '13e'; |
||
| 901 | $this->_lang['ordinal: 14'] = '14e'; |
||
| 902 | $this->_lang['ordinal: 15'] = '15e'; |
||
| 903 | $this->_lang['ordinal: 16'] = '16e'; |
||
| 904 | $this->_lang['ordinal: 17'] = '17e'; |
||
| 905 | $this->_lang['ordinal: 18'] = '18e'; |
||
| 906 | $this->_lang['ordinal: 19'] = '19e'; |
||
| 907 | $this->_lang['ordinal: 20'] = '20e'; |
||
| 908 | $this->_lang['ordinal: 21'] = '21e'; |
||
| 909 | $this->_lang['ordinal: 22'] = '22e'; |
||
| 910 | $this->_lang['ordinal: 23'] = '23e'; |
||
| 911 | $this->_lang['ordinal: 24'] = '24e'; |
||
| 912 | $this->_lang['ordinal: 25'] = '25e'; |
||
| 913 | $this->_lang['ordinal: 26'] = '26e'; |
||
| 914 | $this->_lang['ordinal: 27'] = '27e'; |
||
| 915 | $this->_lang['ordinal: 28'] = '28e'; |
||
| 916 | $this->_lang['ordinal: 29'] = '29e'; |
||
| 917 | $this->_lang['ordinal: 30'] = '30e'; |
||
| 918 | $this->_lang['ordinal: 31'] = '31e'; |
||
| 919 | $this->_lang['ordinal: 32'] = '32e'; |
||
| 920 | $this->_lang['ordinal: 33'] = '33e'; |
||
| 921 | $this->_lang['ordinal: 34'] = '34e'; |
||
| 922 | $this->_lang['ordinal: 35'] = '35e'; |
||
| 923 | $this->_lang['ordinal: 36'] = '36e'; |
||
| 924 | $this->_lang['ordinal: 37'] = '37e'; |
||
| 925 | $this->_lang['ordinal: 38'] = '38e'; |
||
| 926 | $this->_lang['ordinal: 39'] = '39e'; |
||
| 927 | $this->_lang['ordinal: 40'] = '40e'; |
||
| 928 | $this->_lang['ordinal: 41'] = '41e'; |
||
| 929 | $this->_lang['ordinal: 42'] = '42e'; |
||
| 930 | $this->_lang['ordinal: 43'] = '43e'; |
||
| 931 | $this->_lang['ordinal: 44'] = '44e'; |
||
| 932 | $this->_lang['ordinal: 45'] = '45e'; |
||
| 933 | $this->_lang['ordinal: 46'] = '46e'; |
||
| 934 | $this->_lang['ordinal: 47'] = '47e'; |
||
| 935 | $this->_lang['ordinal: 48'] = '48e'; |
||
| 936 | $this->_lang['ordinal: 49'] = '49e'; |
||
| 937 | $this->_lang['ordinal: 50'] = '50e'; |
||
| 938 | $this->_lang['ordinal: 51'] = '51e'; |
||
| 939 | $this->_lang['ordinal: 52'] = '52e'; |
||
| 940 | $this->_lang['ordinal: 53'] = '53e'; |
||
| 941 | $this->_lang['ordinal: 54'] = '54e'; |
||
| 942 | $this->_lang['ordinal: 55'] = '55e'; |
||
| 943 | $this->_lang['ordinal: 56'] = '56e'; |
||
| 944 | $this->_lang['ordinal: 57'] = '57e'; |
||
| 945 | $this->_lang['ordinal: 58'] = '58e'; |
||
| 946 | $this->_lang['ordinal: 59'] = '59e'; |
||
| 947 | break; |
||
| 948 | } |
||
| 949 | } |
||
| 950 | |||
| 951 | final private function natlangPad2($number) |
||
| 954 | } |
||
| 955 | |||
| 956 | final private function natlangApply($id, $p1 = false, $p2 = false, $p3 = false, $p4 = false, $p5 = false, $p6 = false) |
||
| 957 | { |
||
| 958 | $txt = $this->_lang[$id]; |
||
| 959 | if ($p1 !== false) { |
||
| 960 | $txt = str_replace('@1', $p1, $txt); |
||
| 961 | } |
||
| 962 | if ($p2 !== false) { |
||
| 963 | $txt = str_replace('@2', $p2, $txt); |
||
| 964 | } |
||
| 965 | if ($p3 !== false) { |
||
| 966 | $txt = str_replace('@3', $p3, $txt); |
||
| 967 | } |
||
| 968 | if ($p4 !== false) { |
||
| 969 | $txt = str_replace('@4', $p4, $txt); |
||
| 970 | } |
||
| 971 | if ($p5 !== false) { |
||
| 972 | $txt = str_replace('@5', $p5, $txt); |
||
| 973 | } |
||
| 974 | if ($p6 !== false) { |
||
| 975 | $txt = str_replace('@6', $p6, $txt); |
||
| 976 | } |
||
| 977 | |||
| 978 | return $txt; |
||
| 979 | } |
||
| 980 | |||
| 981 | // |
||
| 982 | // Function: natlangRange |
||
| 983 | // |
||
| 984 | // Description: Converts a range into natural language |
||
| 985 | // |
||
| 986 | // Parameters: |
||
| 987 | // |
||
| 988 | // Result: |
||
| 989 | // |
||
| 990 | final private function natlangRange($spec, $entryFunction, $p1 = false) |
||
| 991 | { |
||
| 992 | $arrIntervals = []; |
||
| 993 | foreach ($spec['elements'] as $elem) { |
||
| 994 | $arrIntervals[] = call_user_func($entryFunction, $elem, $p1); |
||
| 995 | } |
||
| 996 | $txt = ''; |
||
| 997 | for ($index = 0; $index < count($arrIntervals); $index++) { |
||
| 998 | $txt .= ($index == 0 ? '' : ($index == (count($arrIntervals) - 1) ? ' '.$this->natlangApply('separator_and').' ' : ', ')).$arrIntervals[$index]; |
||
| 999 | } |
||
| 1000 | |||
| 1001 | return $txt; |
||
| 1002 | } |
||
| 1003 | |||
| 1004 | // |
||
| 1005 | // Function: natlangElementMinute |
||
| 1006 | // |
||
| 1007 | // Description: Converts an entry from the minute specification to natural language. |
||
| 1008 | // |
||
| 1009 | final private function natlangElementMinute($elem) |
||
| 1010 | { |
||
| 1011 | if (!$elem['hasInterval']) { |
||
| 1012 | if ($elem['number1'] == 0) { |
||
| 1013 | return $this->natlangApply('elemMin: at_the_hour'); |
||
| 1014 | } else { |
||
| 1015 | return $this->natlangApply('elemMin: after_the_hour_every_X_minute'.($elem['number1'] == 1 ? '' : '_plural'), $elem['number1']); |
||
| 1016 | } |
||
| 1017 | } |
||
| 1018 | $txt = $this->natlangApply('elemMin: every_consecutive_minute'.($elem['interval'] == 1 ? '' : '_plural'), $elem['interval']); |
||
| 1019 | if (($elem['number1'] != $this->_cronMinutes['rangeMin']) || ($elem['number2'] != $this->_cronMinutes['rangeMax'])) { |
||
| 1020 | $txt .= ' ('.$this->natlangApply('elemMin: between_X_and_Y', $this->natlangApply('ordinal: '.$elem['number1']), $this->natlangApply('ordinal: '.$elem['number2'])).')'; |
||
| 1021 | } |
||
| 1022 | |||
| 1023 | return $txt; |
||
| 1024 | } |
||
| 1025 | |||
| 1026 | // |
||
| 1027 | // Function: natlangElementHour |
||
| 1028 | // |
||
| 1029 | // Description: Converts an entry from the hour specification to natural language. |
||
| 1030 | // |
||
| 1031 | final private function natlangElementHour($elem, $asBetween) |
||
| 1032 | { |
||
| 1033 | if (!$elem['hasInterval']) { |
||
| 1034 | if ($asBetween) { |
||
| 1035 | return $this->natlangApply('elemHour: between_X:00_and_Y:59', $this->natlangPad2($elem['number1']), $this->natlangPad2($elem['number1'])); |
||
| 1036 | } else { |
||
| 1037 | return $this->natlangApply('elemHour: past_X:00', $this->natlangPad2($elem['number1'])); |
||
| 1038 | } |
||
| 1039 | } |
||
| 1040 | if ($asBetween) { |
||
| 1041 | $txt = $this->natlangApply('elemHour: in_the_60_minutes_past_'.($elem['interval'] == 1 ? '' : '_plural'), $elem['interval']); |
||
| 1042 | } else { |
||
| 1043 | $txt = $this->natlangApply('elemHour: past_every_consecutive_'.($elem['interval'] == 1 ? '' : '_plural'), $elem['interval']); |
||
| 1044 | } |
||
| 1045 | if (($elem['number1'] != $this->_cronHours['rangeMin']) || ($elem['number2'] != $this->_cronHours['rangeMax'])) { |
||
| 1046 | $txt .= ' ('.$this->natlangApply('elemHour: between_X:00_and_Y:59', $elem['number1'], $elem['number2']).')'; |
||
| 1047 | } |
||
| 1048 | |||
| 1049 | return $txt; |
||
| 1050 | } |
||
| 1051 | |||
| 1052 | // |
||
| 1053 | // Function: natlangElementDayOfMonth |
||
| 1054 | // |
||
| 1055 | // Description: Converts an entry from the day of month specification to natural language. |
||
| 1056 | // |
||
| 1057 | final private function natlangElementDayOfMonth($elem) |
||
| 1068 | } |
||
| 1069 | |||
| 1070 | // |
||
| 1071 | // Function: natlangElementDayOfMonth |
||
| 1072 | // |
||
| 1073 | // Description: Converts an entry from the month specification to natural language. |
||
| 1074 | // |
||
| 1075 | final private function natlangElementMonth($elem) |
||
| 1086 | } |
||
| 1087 | |||
| 1088 | // |
||
| 1089 | // Function: natlangElementYear |
||
| 1090 | // |
||
| 1091 | // Description: Converts an entry from the year specification to natural language. |
||
| 1092 | // |
||
| 1093 | final private function natlangElementYear($elem) |
||
| 1104 | } |
||
| 1105 | |||
| 1106 | // |
||
| 1107 | // Function: asNaturalLanguage |
||
| 1108 | // |
||
| 1109 | // Description: Returns the current cron specification in natural language. |
||
| 1110 | // |
||
| 1111 | // Parameters: None |
||
| 1112 | // |
||
| 1113 | // Result: A string containing a natural language text. |
||
| 1114 | // |
||
| 1115 | final public function asNaturalLanguage() |
||
| 1270 | } |
||
| 1271 | } |
||
| 1272 |
Loading history...