notifier / libraries / action-scheduler / lib / cron-expression / CronExpression_DayOfWeekField.php

CronExpression_DayOfWeekField.php in WANotifier for Forms and Actions 2.7.5, at libraries/action-scheduler/lib/cron-expression/CronExpression_DayOfWeekField.php

125 lines 3.8 KB

Raw Download Zip

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 <mtdowling@gmail.com>
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