ILIAS  release_8 Revision v8.24
class.ilADTDateTimeSearchBridgeRange.php
Go to the documentation of this file.
1<?php
2
3declare(strict_types=1);
4
26{
27 protected function isValidADTDefinition(ilADTDefinition $a_adt_def): bool
28 {
29 return ($a_adt_def instanceof ilADTDateTimeDefinition);
30 }
31
32 // table2gui / filter
33
34 public function loadFilter(): void
35 {
36 $value = $this->readFilter();
37 if (isset($value) && is_array($value)) {
38 if ($value["lower"] ?? false) {
39 $this->getLowerADT()->setDate(new ilDateTime($value["lower"], IL_CAL_DATETIME));
40 }
41 if ($value["upper"] ?? false) {
42 $this->getUpperADT()->setDate(new ilDateTime($value["upper"], IL_CAL_DATETIME));
43 }
44 }
45 }
46
47 // form
48
49 public function addToForm(): void
50 {
51 if ($this->getForm() instanceof ilPropertyFormGUI) {
52 // :TODO: use DateDurationInputGUI ?!
53
54 $check = new ilCustomInputGUI($this->getTitle());
55
56 $date_from = new ilDateTimeInputGUI($this->lng->txt('from'), $this->addToElementId("lower"));
57 $date_from->setShowTime(true);
58 $check->addSubItem($date_from);
59
60 if ($this->getLowerADT()->getDate() && !$this->getLowerADT()->isNull()) {
61 $date_from->setDate($this->getLowerADT()->getDate());
62 $checked = true;
63 }
64
65 $date_until = new ilDateTimeInputGUI($this->lng->txt('until'), $this->addToElementId("upper"));
66 $date_until->setShowTime(true);
67 $check->addSubItem($date_until);
68
69 if ($this->getUpperADT()->getDate() && !$this->getUpperADT()->isNull()) {
70 $date_until->setDate($this->getUpperADT()->getDate());
71 $checked = true;
72 }
73
75 } else {
76 // see ilTable2GUI::addFilterItemByMetaType()
77 $item = new ilCombinationInputGUI($this->getTitle(), $this->getElementId());
78
79 $lower = new ilDateTimeInputGUI("", $this->addToElementId("lower"));
80 $lower->setShowTime(true);
81 $item->addCombinationItem("lower", $lower, $this->lng->txt("from"));
82
83 if ($this->getLowerADT()->getDate() && !$this->getLowerADT()->isNull()) {
84 $lower->setDate($this->getLowerADT()->getDate());
85 }
86
87 $upper = new ilDateTimeInputGUI("", $this->addToElementId("upper"));
88 $upper->setShowTime(true);
89 $item->addCombinationItem("upper", $upper, $this->lng->txt("to"));
90
91 if ($this->getUpperADT()->getDate() && !$this->getUpperADT()->isNull()) {
92 $upper->setDate($this->getUpperADT()->getDate());
93 }
94
95 $item->setComparisonMode(ilCombinationInputGUI::COMPARISON_ASCENDING);
96
97 $this->addToParentElement($item);
98 }
99 }
100
101 protected function shouldBeImportedFromPost($a_post): bool
102 {
103 if ($this->getForm() instanceof ilPropertyFormGUI) {
104 return ($a_post['lower'] ?? false) || ($a_post['upper'] ?? false);
105 }
106 return parent::shouldBeImportedFromPost($a_post);
107 }
108
109 public function importFromPost(array $a_post = null): bool
110 {
111 $post = $this->extractPostValues($a_post);
112
113 if ($post && $this->shouldBeImportedFromPost($post)) {
114 $start = ilCalendarUtil::parseIncomingDate($post["lower"], true);
115 $end = ilCalendarUtil::parseIncomingDate($post["upper"], true);
116 if ($start && $end && $start->get(IL_CAL_UNIX) > $end->get(IL_CAL_UNIX)) {
117 $tmp = $start;
118 $start = $end;
119 $end = $tmp;
120 }
121
122 if ($this->getForm() instanceof ilPropertyFormGUI) {
123 $item = $this->getForm()->getItemByPostVar($this->getElementId() . "[lower]");
124 $item->setDate($start);
125
126 $item = $this->getForm()->getItemByPostVar($this->getElementId() . "[upper]");
127 $item->setDate($end);
128 } elseif (array_key_exists($this->getElementId(), $this->table_filter_fields)) {
129 $this->table_filter_fields[$this->getElementId()]->getCombinationItem("lower")->setDate($start);
130 $this->table_filter_fields[$this->getElementId()]->getCombinationItem("upper")->setDate($end);
131 $this->writeFilter(array(
132 "lower" => (!$start || $start->isNull()) ? null : $start->get(IL_CAL_DATETIME),
133 "upper" => (!$end || $end->isNull()) ? null : $end->get(IL_CAL_DATETIME)
134 ));
135 }
136
137 $this->getLowerADT()->setDate($start);
138 $this->getUpperADT()->setDate($end);
139 } else {
140 $this->getLowerADT()->setDate();
141 $this->getUpperADT()->setDate();
142 }
143 return true;
144 }
145
146 // db
147
148 public function getSQLCondition(string $a_element_id, int $mode = self::SQL_LIKE, array $quotedWords = []): string
149 {
150 if (!$this->isNull() && $this->isValid()) {
151 $sql = array();
152 if (!$this->getLowerADT()->isNull()) {
153 $sql[] = $a_element_id . " >= " . $this->db->quote(
154 $this->getLowerADT()->getDate()->get(IL_CAL_DATETIME),
155 "timestamp"
156 );
157 }
158 if (!$this->getUpperADT()->isNull()) {
159 $sql[] = $a_element_id . " <= " . $this->db->quote(
160 $this->getUpperADT()->getDate()->get(IL_CAL_DATETIME),
161 "timestamp"
162 );
163 }
164 return "(" . implode(" AND ", $sql) . ")";
165 }
166 return '';
167 }
168
169 public function isInCondition(ilADT $a_adt): bool
170 {
171 assert($a_adt instanceof ilADTDateTime);
172
173 if (!$this->getLowerADT()->isNull() && !$this->getUpperADT()->isNull()) {
174 return (bool) $a_adt->isInbetweenOrEqual($this->getLowerADT(), $this->getUpperADT());
175 } elseif (!$this->getLowerADT()->isNull()) {
176 return (bool) $a_adt->isLargerOrEqual($this->getLowerADT());
177 } else {
178 return (bool) $a_adt->isSmallerOrEqual($this->getUpperADT());
179 }
180 }
181
182 // import/export
183
184 public function getSerializedValue(): string
185 {
186 if (!$this->isNull() && $this->isValid()) {
187 $res = array();
188 if (!$this->getLowerADT()->isNull()) {
189 $res["lower"] = $this->getLowerADT()->getDate()->get(IL_CAL_DATETIME);
190 }
191 if (!$this->getUpperADT()->isNull()) {
192 $res["upper"] = $this->getUpperADT()->getDate()->get(IL_CAL_DATETIME);
193 }
194 return serialize($res);
195 }
196 return '';
197 }
198
199 public function setSerializedValue(string $a_value): void
200 {
201 $a_value = unserialize($a_value);
202 if (is_array($a_value)) {
203 if (isset($a_value["lower"])) {
204 $this->getLowerADT()->setDate(new ilDateTime($a_value["lower"], IL_CAL_DATETIME));
205 }
206 if (isset($a_value["upper"])) {
207 $this->getUpperADT()->setDate(new ilDateTime($a_value["upper"], IL_CAL_DATETIME));
208 }
209 }
210 }
211}
$check
Definition: buildRTE.php:81
const IL_CAL_UNIX
const IL_CAL_DATETIME
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
setSerializedValue(string $a_value)
Set current value(s) in serialized form (for easy persisting)
shouldBeImportedFromPost($a_post)
Check if incoming values should be imported at all.
isInCondition(ilADT $a_adt)
Compare directly against ADT.
getSQLCondition(string $a_element_id, int $mode=self::SQL_LIKE, array $quotedWords=[])
Get SQL condition for current value(s)
getSerializedValue()
Get current value(s) in serialized form (for easy persisting)
ADT definition base class.
Class ilADTSearchBridgeRange.
addToElementId(string $a_add)
Add sub-element.
readFilter()
Load value(s) from filter store (in session)
extractPostValues(array $a_post=null)
Extract data from (post) values.
addToParentElement(ilFormPropertyGUI $a_field)
Add form field to parent element.
writeFilter($a_value=null)
Write value(s) to filter store (in session)
ADT base class.
Definition: class.ilADT.php:12
isSmallerOrEqual(ilADT $a_adt)
Check if given ADT is smaller or equal than self.
isLargerOrEqual(ilADT $a_adt)
isInbetweenOrEqual(ilADT $a_adt_from, ilADT $a_adt_to)
Check if self is inbetween given ADTs (inclusive)
static parseIncomingDate($a_value, bool $a_add_time=false)
Try to parse incoming value to date object.
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
This file is part of ILIAS, a powerful learning management system published by ILIAS open source e-Le...
@classDescription Date and time handling
This class represents a property form user interface.
$res
Definition: ltiservices.php:69
$post
Definition: ltitoken.php:49