1
|
|
|
<?php |
2
|
|
|
|
3
|
|
|
/** |
4
|
|
|
* Day of week field. Allows: * / , - ? L # |
5
|
|
|
* |
6
|
|
|
* Days of the week can be represented as a number 0-7 (0|7 = Sunday) |
7
|
|
|
* or as a three letter string: SUN, MON, TUE, WED, THU, FRI, SAT. |
8
|
|
|
* |
9
|
|
|
* 'L' stands for "last". It allows you to specify constructs such as |
10
|
|
|
* "the last Friday" of a given month. |
11
|
|
|
* |
12
|
|
|
* '#' is allowed for the day-of-week field, and must be followed by a |
13
|
|
|
* number between one and five. It allows you to specify constructs such as |
14
|
|
|
* "the second Friday" of a given month. |
15
|
|
|
* |
16
|
|
|
* @author Michael Dowling <[email protected]> |
17
|
|
|
*/ |
18
|
|
|
class CronExpression_DayOfWeekField extends CronExpression_AbstractField |
19
|
|
|
{ |
20
|
|
|
/** |
21
|
|
|
* {@inheritdoc} |
22
|
|
|
*/ |
23
|
|
|
public function isSatisfiedBy(DateTime $date, $value) |
24
|
|
|
{ |
25
|
|
|
if ($value == '?') { |
26
|
|
|
return true; |
27
|
|
|
} |
28
|
|
|
|
29
|
|
|
// Convert text day of the week values to integers |
30
|
|
|
$value = str_ireplace( |
31
|
|
|
array('SUN', 'MON', 'TUE', 'WED', 'THU', 'FRI', 'SAT'), |
32
|
|
|
range(0, 6), |
33
|
|
|
$value |
34
|
|
|
); |
35
|
|
|
|
36
|
|
|
$currentYear = $date->format('Y'); |
37
|
|
|
$currentMonth = $date->format('m'); |
38
|
|
|
$lastDayOfMonth = $date->format('t'); |
39
|
|
|
|
40
|
|
|
// Find out if this is the last specific weekday of the month |
41
|
|
|
if (strpos($value, 'L')) { |
42
|
|
|
$weekday = str_replace('7', '0', substr($value, 0, strpos($value, 'L'))); |
43
|
|
|
$tdate = clone $date; |
44
|
|
|
$tdate->setDate($currentYear, $currentMonth, $lastDayOfMonth); |
|
|
|
|
45
|
|
|
while ($tdate->format('w') != $weekday) { |
46
|
|
|
$tdate->setDate($currentYear, $currentMonth, --$lastDayOfMonth); |
47
|
|
|
} |
48
|
|
|
|
49
|
|
|
return $date->format('j') == $lastDayOfMonth; |
50
|
|
|
} |
51
|
|
|
|
52
|
|
|
// Handle # hash tokens |
53
|
|
|
if (strpos($value, '#')) { |
54
|
|
|
list($weekday, $nth) = explode('#', $value); |
55
|
|
|
// Validate the hash fields |
56
|
|
|
if ($weekday < 1 || $weekday > 5) { |
57
|
|
|
throw new InvalidArgumentException("Weekday must be a value between 1 and 5. {$weekday} given"); |
58
|
|
|
} |
59
|
|
|
if ($nth > 5) { |
60
|
|
|
throw new InvalidArgumentException('There are never more than 5 of a given weekday in a month'); |
61
|
|
|
} |
62
|
|
|
// The current weekday must match the targeted weekday to proceed |
63
|
|
|
if ($date->format('N') != $weekday) { |
64
|
|
|
return false; |
65
|
|
|
} |
66
|
|
|
|
67
|
|
|
$tdate = clone $date; |
68
|
|
|
$tdate->setDate($currentYear, $currentMonth, 1); |
69
|
|
|
$dayCount = 0; |
70
|
|
|
$currentDay = 1; |
71
|
|
|
while ($currentDay < $lastDayOfMonth + 1) { |
72
|
|
|
if ($tdate->format('N') == $weekday) { |
73
|
|
|
if (++$dayCount >= $nth) { |
74
|
|
|
break; |
75
|
|
|
} |
76
|
|
|
} |
77
|
|
|
$tdate->setDate($currentYear, $currentMonth, ++$currentDay); |
78
|
|
|
} |
79
|
|
|
|
80
|
|
|
return $date->format('j') == $currentDay; |
81
|
|
|
} |
82
|
|
|
|
83
|
|
|
// Handle day of the week values |
84
|
|
|
if (strpos($value, '-')) { |
85
|
|
|
$parts = explode('-', $value); |
86
|
|
|
if ($parts[0] == '7') { |
87
|
|
|
$parts[0] = '0'; |
88
|
|
|
} elseif ($parts[1] == '0') { |
89
|
|
|
$parts[1] = '7'; |
90
|
|
|
} |
91
|
|
|
$value = implode('-', $parts); |
92
|
|
|
} |
93
|
|
|
|
94
|
|
|
// Test to see which Sunday to use -- 0 == 7 == Sunday |
95
|
|
|
$format = in_array(7, str_split($value)) ? 'N' : 'w'; |
96
|
|
|
$fieldValue = $date->format($format); |
97
|
|
|
|
98
|
|
|
return $this->isSatisfied($fieldValue, $value); |
99
|
|
|
} |
100
|
|
|
|
101
|
|
|
/** |
102
|
|
|
* {@inheritdoc} |
103
|
|
|
*/ |
104
|
|
|
public function increment(DateTime $date, $invert = false) |
105
|
|
|
{ |
106
|
|
|
if ($invert) { |
107
|
|
|
$date->modify('-1 day'); |
108
|
|
|
$date->setTime(23, 59, 0); |
109
|
|
|
} else { |
110
|
|
|
$date->modify('+1 day'); |
111
|
|
|
$date->setTime(0, 0, 0); |
112
|
|
|
} |
113
|
|
|
|
114
|
|
|
return $this; |
115
|
|
|
} |
116
|
|
|
|
117
|
|
|
/** |
118
|
|
|
* {@inheritdoc} |
119
|
|
|
*/ |
120
|
|
|
public function validate($value) |
121
|
|
|
{ |
122
|
|
|
return (bool) preg_match('/[\*,\/\-0-9A-Z]+/', $value); |
123
|
|
|
} |
124
|
|
|
} |
125
|
|
|
|