YetiForceCompany / YetiForceCRM

libraries/SabreDAV/VObject/Parser/Json.php

Unused Use Statements +1 added lines, -1 removed lines

@@ -4,8 +4,8 @@
 
 use Sabre\VObject\Component\VCalendar;
 use Sabre\VObject\Component\VCard;
-use Sabre\VObject\ParseException;
 use Sabre\VObject\EofException;
+use Sabre\VObject\ParseException;
 
 /**
  * Json Parser.

Indentation +175 added lines, -175 removed lines

@@ -18,180 +18,180 @@
  */
 class Json extends Parser {
 
-    /**
-     * The input data.
-     *
-     * @var array
-     */
-    protected $input;
-
-    /**
-     * Root component.
-     *
-     * @var Document
-     */
-    protected $root;
-
-    /**
-     * This method starts the parsing process.
-     *
-     * If the input was not supplied during construction, it's possible to pass
-     * it here instead.
-     *
-     * If either input or options are not supplied, the defaults will be used.
-     *
-     * @param resource|string|array|null $input
-     * @param int $options
-     *
-     * @return Sabre\VObject\Document
-     */
-    public function parse($input = null, $options = 0) {
-
-        if (!is_null($input)) {
-            $this->setInput($input);
-        }
-        if (is_null($this->input)) {
-            throw new EofException('End of input stream, or no input supplied');
-        }
-
-        if (0 !== $options) {
-            $this->options = $options;
-        }
-
-        switch ($this->input[0]) {
-            case 'vcalendar' :
-                $this->root = new VCalendar([], false);
-                break;
-            case 'vcard' :
-                $this->root = new VCard([], false);
-                break;
-            default :
-                throw new ParseException('The root component must either be a vcalendar, or a vcard');
-
-        }
-        foreach ($this->input[1] as $prop) {
-            $this->root->add($this->parseProperty($prop));
-        }
-        if (isset($this->input[2])) foreach ($this->input[2] as $comp) {
-            $this->root->add($this->parseComponent($comp));
-        }
-
-        // Resetting the input so we can throw an feof exception the next time.
-        $this->input = null;
-
-        return $this->root;
-
-    }
-
-    /**
-     * Parses a component.
-     *
-     * @param array $jComp
-     *
-     * @return \Sabre\VObject\Component
-     */
-    public function parseComponent(array $jComp) {
-
-        // We can remove $self from PHP 5.4 onward.
-        $self = $this;
-
-        $properties = array_map(
-            function($jProp) use ($self) {
-                return $self->parseProperty($jProp);
-            },
-            $jComp[1]
-        );
-
-        if (isset($jComp[2])) {
-
-            $components = array_map(
-                function($jComp) use ($self) {
-                    return $self->parseComponent($jComp);
-                },
-                $jComp[2]
-            );
-
-        } else $components = [];
-
-        return $this->root->createComponent(
-            $jComp[0],
-            array_merge($properties, $components),
-            $defaults = false
-        );
-
-    }
-
-    /**
-     * Parses properties.
-     *
-     * @param array $jProp
-     *
-     * @return \Sabre\VObject\Property
-     */
-    public function parseProperty(array $jProp) {
-
-        list(
-            $propertyName,
-            $parameters,
-            $valueType
-        ) = $jProp;
-
-        $propertyName = strtoupper($propertyName);
-
-        // This is the default class we would be using if we didn't know the
-        // value type. We're using this value later in this function.
-        $defaultPropertyClass = $this->root->getClassNameForPropertyName($propertyName);
-
-        $parameters = (array)$parameters;
-
-        $value = array_slice($jProp, 3);
-
-        $valueType = strtoupper($valueType);
-
-        if (isset($parameters['group'])) {
-            $propertyName = $parameters['group'] . '.' . $propertyName;
-            unset($parameters['group']);
-        }
-
-        $prop = $this->root->createProperty($propertyName, null, $parameters, $valueType);
-        $prop->setJsonValue($value);
-
-        // We have to do something awkward here. FlatText as well as Text
-        // represents TEXT values. We have to normalize these here. In the
-        // future we can get rid of FlatText once we're allowed to break BC
-        // again.
-        if ($defaultPropertyClass === 'Sabre\VObject\Property\FlatText') {
-            $defaultPropertyClass = 'Sabre\VObject\Property\Text';
-        }
-
-        // If the value type we received (e.g.: TEXT) was not the default value
-        // type for the given property (e.g.: BDAY), we need to add a VALUE=
-        // parameter.
-        if ($defaultPropertyClass !== get_class($prop)) {
-            $prop["VALUE"] = $valueType;
-        }
-
-        return $prop;
-
-    }
-
-    /**
-     * Sets the input data.
-     *
-     * @param resource|string|array $input
-     *
-     * @return void
-     */
-    public function setInput($input) {
-
-        if (is_resource($input)) {
-            $input = stream_get_contents($input);
-        }
-        if (is_string($input)) {
-            $input = json_decode($input);
-        }
-        $this->input = $input;
-
-    }
+	/**
+	 * The input data.
+	 *
+	 * @var array
+	 */
+	protected $input;
+
+	/**
+	 * Root component.
+	 *
+	 * @var Document
+	 */
+	protected $root;
+
+	/**
+	 * This method starts the parsing process.
+	 *
+	 * If the input was not supplied during construction, it's possible to pass
+	 * it here instead.
+	 *
+	 * If either input or options are not supplied, the defaults will be used.
+	 *
+	 * @param resource|string|array|null $input
+	 * @param int $options
+	 *
+	 * @return Sabre\VObject\Document
+	 */
+	public function parse($input = null, $options = 0) {
+
+		if (!is_null($input)) {
+			$this->setInput($input);
+		}
+		if (is_null($this->input)) {
+			throw new EofException('End of input stream, or no input supplied');
+		}
+
+		if (0 !== $options) {
+			$this->options = $options;
+		}
+
+		switch ($this->input[0]) {
+			case 'vcalendar' :
+				$this->root = new VCalendar([], false);
+				break;
+			case 'vcard' :
+				$this->root = new VCard([], false);
+				break;
+			default :
+				throw new ParseException('The root component must either be a vcalendar, or a vcard');
+
+		}
+		foreach ($this->input[1] as $prop) {
+			$this->root->add($this->parseProperty($prop));
+		}
+		if (isset($this->input[2])) foreach ($this->input[2] as $comp) {
+			$this->root->add($this->parseComponent($comp));
+		}
+
+		// Resetting the input so we can throw an feof exception the next time.
+		$this->input = null;
+
+		return $this->root;
+
+	}
+
+	/**
+	 * Parses a component.
+	 *
+	 * @param array $jComp
+	 *
+	 * @return \Sabre\VObject\Component
+	 */
+	public function parseComponent(array $jComp) {
+
+		// We can remove $self from PHP 5.4 onward.
+		$self = $this;
+
+		$properties = array_map(
+			function($jProp) use ($self) {
+				return $self->parseProperty($jProp);
+			},
+			$jComp[1]
+		);
+
+		if (isset($jComp[2])) {
+
+			$components = array_map(
+				function($jComp) use ($self) {
+					return $self->parseComponent($jComp);
+				},
+				$jComp[2]
+			);
+
+		} else $components = [];
+
+		return $this->root->createComponent(
+			$jComp[0],
+			array_merge($properties, $components),
+			$defaults = false
+		);
+
+	}
+
+	/**
+	 * Parses properties.
+	 *
+	 * @param array $jProp
+	 *
+	 * @return \Sabre\VObject\Property
+	 */
+	public function parseProperty(array $jProp) {
+
+		list(
+			$propertyName,
+			$parameters,
+			$valueType
+		) = $jProp;
+
+		$propertyName = strtoupper($propertyName);
+
+		// This is the default class we would be using if we didn't know the
+		// value type. We're using this value later in this function.
+		$defaultPropertyClass = $this->root->getClassNameForPropertyName($propertyName);
+
+		$parameters = (array)$parameters;
+
+		$value = array_slice($jProp, 3);
+
+		$valueType = strtoupper($valueType);
+
+		if (isset($parameters['group'])) {
+			$propertyName = $parameters['group'] . '.' . $propertyName;
+			unset($parameters['group']);
+		}
+
+		$prop = $this->root->createProperty($propertyName, null, $parameters, $valueType);
+		$prop->setJsonValue($value);
+
+		// We have to do something awkward here. FlatText as well as Text
+		// represents TEXT values. We have to normalize these here. In the
+		// future we can get rid of FlatText once we're allowed to break BC
+		// again.
+		if ($defaultPropertyClass === 'Sabre\VObject\Property\FlatText') {
+			$defaultPropertyClass = 'Sabre\VObject\Property\Text';
+		}
+
+		// If the value type we received (e.g.: TEXT) was not the default value
+		// type for the given property (e.g.: BDAY), we need to add a VALUE=
+		// parameter.
+		if ($defaultPropertyClass !== get_class($prop)) {
+			$prop["VALUE"] = $valueType;
+		}
+
+		return $prop;
+
+	}
+
+	/**
+	 * Sets the input data.
+	 *
+	 * @param resource|string|array $input
+	 *
+	 * @return void
+	 */
+	public function setInput($input) {
+
+		if (is_resource($input)) {
+			$input = stream_get_contents($input);
+		}
+		if (is_string($input)) {
+			$input = json_decode($input);
+		}
+		$this->input = $input;
+
+	}
 
 }

libraries/SabreDAV/VObject/Property/UtcOffset.php

Indentation +52 added lines, -52 removed lines

@@ -13,65 +13,65 @@
  */
 class UtcOffset extends Text {
 
-    /**
-     * In case this is a multi-value property. This string will be used as a
-     * delimiter.
-     *
-     * @var string|null
-     */
-    public $delimiter = null;
+	/**
+	 * In case this is a multi-value property. This string will be used as a
+	 * delimiter.
+	 *
+	 * @var string|null
+	 */
+	public $delimiter = null;
 
-    /**
-     * Returns the type of value.
-     *
-     * This corresponds to the VALUE= parameter. Every property also has a
-     * 'default' valueType.
-     *
-     * @return string
-     */
-    public function getValueType() {
+	/**
+	 * Returns the type of value.
+	 *
+	 * This corresponds to the VALUE= parameter. Every property also has a
+	 * 'default' valueType.
+	 *
+	 * @return string
+	 */
+	public function getValueType() {
 
-        return 'UTC-OFFSET';
+		return 'UTC-OFFSET';
 
-    }
+	}
 
-    /**
-     * Sets the JSON value, as it would appear in a jCard or jCal object.
-     *
-     * The value must always be an array.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setJsonValue(array $value) {
+	/**
+	 * Sets the JSON value, as it would appear in a jCard or jCal object.
+	 *
+	 * The value must always be an array.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setJsonValue(array $value) {
 
-        $value = array_map(
-            function($value) {
-                return str_replace(':', '', $value);
-            },
-            $value
-        );
-        parent::setJsonValue($value);
+		$value = array_map(
+			function($value) {
+				return str_replace(':', '', $value);
+			},
+			$value
+		);
+		parent::setJsonValue($value);
 
-    }
+	}
 
-    /**
-     * Returns the value, in the format it should be encoded for JSON.
-     *
-     * This method must always return an array.
-     *
-     * @return array
-     */
-    public function getJsonValue() {
+	/**
+	 * Returns the value, in the format it should be encoded for JSON.
+	 *
+	 * This method must always return an array.
+	 *
+	 * @return array
+	 */
+	public function getJsonValue() {
 
-        return array_map(
-            function($value) {
-                return substr($value, 0, -2) . ':' .
-                       substr($value, -2);
-            },
-            parent::getJsonValue()
-        );
+		return array_map(
+			function($value) {
+				return substr($value, 0, -2) . ':' .
+					   substr($value, -2);
+			},
+			parent::getJsonValue()
+		);
 
-    }
+	}
 }

libraries/SabreDAV/VObject/Property/ICalendar/DateTime.php

Indentation +375 added lines, -375 removed lines

@@ -26,379 +26,379 @@
  */
 class DateTime extends Property {
 
-    /**
-     * In case this is a multi-value property. This string will be used as a
-     * delimiter.
-     *
-     * @var string|null
-     */
-    public $delimiter = ',';
-
-    /**
-     * Sets a multi-valued property.
-     *
-     * You may also specify DateTime objects here.
-     *
-     * @param array $parts
-     *
-     * @return void
-     */
-    public function setParts(array $parts) {
-
-        if (isset($parts[0]) && $parts[0] instanceof DateTimeInterface) {
-            $this->setDateTimes($parts);
-        } else {
-            parent::setParts($parts);
-        }
-
-    }
-
-    /**
-     * Updates the current value.
-     *
-     * This may be either a single, or multiple strings in an array.
-     *
-     * Instead of strings, you may also use DateTime here.
-     *
-     * @param string|array|DateTimeInterface $value
-     *
-     * @return void
-     */
-    public function setValue($value) {
-
-        if (is_array($value) && isset($value[0]) && $value[0] instanceof DateTimeInterface) {
-            $this->setDateTimes($value);
-        } elseif ($value instanceof DateTimeInterface) {
-            $this->setDateTimes([$value]);
-        } else {
-            parent::setValue($value);
-        }
-
-    }
-
-    /**
-     * Sets a raw value coming from a mimedir (iCalendar/vCard) file.
-     *
-     * This has been 'unfolded', so only 1 line will be passed. Unescaping is
-     * not yet done, but parameters are not included.
-     *
-     * @param string $val
-     *
-     * @return void
-     */
-    public function setRawMimeDirValue($val) {
-
-        $this->setValue(explode($this->delimiter, $val));
-
-    }
-
-    /**
-     * Returns a raw mime-dir representation of the value.
-     *
-     * @return string
-     */
-    public function getRawMimeDirValue() {
-
-        return implode($this->delimiter, $this->getParts());
-
-    }
-
-    /**
-     * Returns true if this is a DATE-TIME value, false if it's a DATE.
-     *
-     * @return bool
-     */
-    public function hasTime() {
-
-        return strtoupper((string)$this['VALUE']) !== 'DATE';
-
-    }
-
-    /**
-     * Returns true if this is a floating DATE or DATE-TIME.
-     *
-     * Note that DATE is always floating.
-     */
-    public function isFloating() {
-
-        return
-            !$this->hasTime() ||
-            (
-                !isset($this['TZID']) &&
-                strpos($this->getValue(), 'Z') === false
-            );
-
-    }
-
-    /**
-     * Returns a date-time value.
-     *
-     * Note that if this property contained more than 1 date-time, only the
-     * first will be returned. To get an array with multiple values, call
-     * getDateTimes.
-     *
-     * If no timezone information is known, because it's either an all-day
-     * property or floating time, we will use the DateTimeZone argument to
-     * figure out the exact date.
-     *
-     * @param DateTimeZone $timeZone
-     *
-     * @return DateTimeImmutable
-     */
-    public function getDateTime(DateTimeZone $timeZone = null) {
-
-        $dt = $this->getDateTimes($timeZone);
-        if (!$dt) return;
-
-        return $dt[0];
-
-    }
-
-    /**
-     * Returns multiple date-time values.
-     *
-     * If no timezone information is known, because it's either an all-day
-     * property or floating time, we will use the DateTimeZone argument to
-     * figure out the exact date.
-     *
-     * @param DateTimeZone $timeZone
-     *
-     * @return DateTimeImmutable[]
-     * @return \DateTime[]
-     */
-    public function getDateTimes(DateTimeZone $timeZone = null) {
-
-        // Does the property have a TZID?
-        $tzid = $this['TZID'];
-
-        if ($tzid) {
-            $timeZone = TimeZoneUtil::getTimeZone((string)$tzid, $this->root);
-        }
-
-        $dts = [];
-        foreach ($this->getParts() as $part) {
-            $dts[] = DateTimeParser::parse($part, $timeZone);
-        }
-        return $dts;
-
-    }
-
-    /**
-     * Sets the property as a DateTime object.
-     *
-     * @param DateTimeInterface $dt
-     * @param bool isFloating If set to true, timezones will be ignored.
-     *
-     * @return void
-     */
-    public function setDateTime(DateTimeInterface $dt, $isFloating = false) {
-
-        $this->setDateTimes([$dt], $isFloating);
-
-    }
-
-    /**
-     * Sets the property as multiple date-time objects.
-     *
-     * The first value will be used as a reference for the timezones, and all
-     * the otehr values will be adjusted for that timezone
-     *
-     * @param DateTimeInterface[] $dt
-     * @param bool isFloating If set to true, timezones will be ignored.
-     *
-     * @return void
-     */
-    public function setDateTimes(array $dt, $isFloating = false) {
-
-        $values = [];
-
-        if ($this->hasTime()) {
-
-            $tz = null;
-            $isUtc = false;
-
-            foreach ($dt as $d) {
-
-                if ($isFloating) {
-                    $values[] = $d->format('Ymd\\THis');
-                    continue;
-                }
-                if (is_null($tz)) {
-                    $tz = $d->getTimeZone();
-                    $isUtc = in_array($tz->getName(), ['UTC', 'GMT', 'Z', '+00:00']);
-                    if (!$isUtc) {
-                        $this->offsetSet('TZID', $tz->getName());
-                    }
-                } else {
-                    $d = $d->setTimeZone($tz);
-                }
-
-                if ($isUtc) {
-                    $values[] = $d->format('Ymd\\THis\\Z');
-                } else {
-                    $values[] = $d->format('Ymd\\THis');
-                }
-
-            }
-            if ($isUtc || $isFloating) {
-                $this->offsetUnset('TZID');
-            }
-
-        } else {
-
-            foreach ($dt as $d) {
-
-                $values[] = $d->format('Ymd');
-
-            }
-            $this->offsetUnset('TZID');
-
-        }
-
-        $this->value = $values;
-
-    }
-
-    /**
-     * Returns the type of value.
-     *
-     * This corresponds to the VALUE= parameter. Every property also has a
-     * 'default' valueType.
-     *
-     * @return string
-     */
-    public function getValueType() {
-
-        return $this->hasTime() ? 'DATE-TIME' : 'DATE';
-
-    }
-
-    /**
-     * Returns the value, in the format it should be encoded for JSON.
-     *
-     * This method must always return an array.
-     *
-     * @return array
-     */
-    public function getJsonValue() {
-
-        $dts = $this->getDateTimes();
-        $hasTime = $this->hasTime();
-        $isFloating = $this->isFloating();
-
-        $tz = $dts[0]->getTimeZone();
-        $isUtc = $isFloating ? false : in_array($tz->getName(), ['UTC', 'GMT', 'Z']);
-
-        return array_map(
-            function(DateTimeInterface $dt) use ($hasTime, $isUtc) {
-
-                if ($hasTime) {
-                    return $dt->format('Y-m-d\\TH:i:s') . ($isUtc ? 'Z' : '');
-                } else {
-                    return $dt->format('Y-m-d');
-                }
-
-            },
-            $dts
-        );
-
-    }
-
-    /**
-     * Sets the json value, as it would appear in a jCard or jCal object.
-     *
-     * The value must always be an array.
-     *
-     * @param array $value
-     *
-     * @return void
-     */
-    public function setJsonValue(array $value) {
-
-        // dates and times in jCal have one difference to dates and times in
-        // iCalendar. In jCal date-parts are separated by dashes, and
-        // time-parts are separated by colons. It makes sense to just remove
-        // those.
-        $this->setValue(
-            array_map(
-                function($item) {
-
-                    return strtr($item, [':' => '', '-' => '']);
-
-                },
-                $value
-            )
-        );
-
-    }
-
-    /**
-     * We need to intercept offsetSet, because it may be used to alter the
-     * VALUE from DATE-TIME to DATE or vice-versa.
-     *
-     * @param string $name
-     * @param mixed $value
-     *
-     * @return void
-     */
-    public function offsetSet($name, $value) {
-
-        parent::offsetSet($name, $value);
-        if (strtoupper($name) !== 'VALUE') {
-            return;
-        }
-
-        // This will ensure that dates are correctly encoded.
-        $this->setDateTimes($this->getDateTimes());
-
-    }
-
-    /**
-     * Validates the node for correctness.
-     *
-     * The following options are supported:
-     *   Node::REPAIR - May attempt to automatically repair the problem.
-     *
-     * This method returns an array with detected problems.
-     * Every element has the following properties:
-     *
-     *  * level - problem level.
-     *  * message - A human-readable string describing the issue.
-     *  * node - A reference to the problematic node.
-     *
-     * The level means:
-     *   1 - The issue was repaired (only happens if REPAIR was turned on)
-     *   2 - An inconsequential issue
-     *   3 - A severe issue.
-     *
-     * @param int $options
-     *
-     * @return array
-     */
-    public function validate($options = 0) {
-
-        $messages = parent::validate($options);
-        $valueType = $this->getValueType();
-        $values = $this->getParts();
-        try {
-            foreach ($values as $value) {
-                switch ($valueType) {
-                    case 'DATE' :
-                        DateTimeParser::parseDate($value);
-                        break;
-                    case 'DATE-TIME' :
-                        DateTimeParser::parseDateTime($value);
-                        break;
-                }
-            }
-        } catch (InvalidDataException $e) {
-            $messages[] = [
-                'level'   => 3,
-                'message' => 'The supplied value (' . $value . ') is not a correct ' . $valueType,
-                'node'    => $this,
-            ];
-        }
-        return $messages;
-
-    }
+	/**
+	 * In case this is a multi-value property. This string will be used as a
+	 * delimiter.
+	 *
+	 * @var string|null
+	 */
+	public $delimiter = ',';
+
+	/**
+	 * Sets a multi-valued property.
+	 *
+	 * You may also specify DateTime objects here.
+	 *
+	 * @param array $parts
+	 *
+	 * @return void
+	 */
+	public function setParts(array $parts) {
+
+		if (isset($parts[0]) && $parts[0] instanceof DateTimeInterface) {
+			$this->setDateTimes($parts);
+		} else {
+			parent::setParts($parts);
+		}
+
+	}
+
+	/**
+	 * Updates the current value.
+	 *
+	 * This may be either a single, or multiple strings in an array.
+	 *
+	 * Instead of strings, you may also use DateTime here.
+	 *
+	 * @param string|array|DateTimeInterface $value
+	 *
+	 * @return void
+	 */
+	public function setValue($value) {
+
+		if (is_array($value) && isset($value[0]) && $value[0] instanceof DateTimeInterface) {
+			$this->setDateTimes($value);
+		} elseif ($value instanceof DateTimeInterface) {
+			$this->setDateTimes([$value]);
+		} else {
+			parent::setValue($value);
+		}
+
+	}
+
+	/**
+	 * Sets a raw value coming from a mimedir (iCalendar/vCard) file.
+	 *
+	 * This has been 'unfolded', so only 1 line will be passed. Unescaping is
+	 * not yet done, but parameters are not included.
+	 *
+	 * @param string $val
+	 *
+	 * @return void
+	 */
+	public function setRawMimeDirValue($val) {
+
+		$this->setValue(explode($this->delimiter, $val));
+
+	}
+
+	/**
+	 * Returns a raw mime-dir representation of the value.
+	 *
+	 * @return string
+	 */
+	public function getRawMimeDirValue() {
+
+		return implode($this->delimiter, $this->getParts());
+
+	}
+
+	/**
+	 * Returns true if this is a DATE-TIME value, false if it's a DATE.
+	 *
+	 * @return bool
+	 */
+	public function hasTime() {
+
+		return strtoupper((string)$this['VALUE']) !== 'DATE';
+
+	}
+
+	/**
+	 * Returns true if this is a floating DATE or DATE-TIME.
+	 *
+	 * Note that DATE is always floating.
+	 */
+	public function isFloating() {
+
+		return
+			!$this->hasTime() ||
+			(
+				!isset($this['TZID']) &&
+				strpos($this->getValue(), 'Z') === false
+			);
+
+	}
+
+	/**
+	 * Returns a date-time value.
+	 *
+	 * Note that if this property contained more than 1 date-time, only the
+	 * first will be returned. To get an array with multiple values, call
+	 * getDateTimes.
+	 *
+	 * If no timezone information is known, because it's either an all-day
+	 * property or floating time, we will use the DateTimeZone argument to
+	 * figure out the exact date.
+	 *
+	 * @param DateTimeZone $timeZone
+	 *
+	 * @return DateTimeImmutable
+	 */
+	public function getDateTime(DateTimeZone $timeZone = null) {
+
+		$dt = $this->getDateTimes($timeZone);
+		if (!$dt) return;
+
+		return $dt[0];
+
+	}
+
+	/**
+	 * Returns multiple date-time values.
+	 *
+	 * If no timezone information is known, because it's either an all-day
+	 * property or floating time, we will use the DateTimeZone argument to
+	 * figure out the exact date.
+	 *
+	 * @param DateTimeZone $timeZone
+	 *
+	 * @return DateTimeImmutable[]
+	 * @return \DateTime[]
+	 */
+	public function getDateTimes(DateTimeZone $timeZone = null) {
+
+		// Does the property have a TZID?
+		$tzid = $this['TZID'];
+
+		if ($tzid) {
+			$timeZone = TimeZoneUtil::getTimeZone((string)$tzid, $this->root);
+		}
+
+		$dts = [];
+		foreach ($this->getParts() as $part) {
+			$dts[] = DateTimeParser::parse($part, $timeZone);
+		}
+		return $dts;
+
+	}
+
+	/**
+	 * Sets the property as a DateTime object.
+	 *
+	 * @param DateTimeInterface $dt
+	 * @param bool isFloating If set to true, timezones will be ignored.
+	 *
+	 * @return void
+	 */
+	public function setDateTime(DateTimeInterface $dt, $isFloating = false) {
+
+		$this->setDateTimes([$dt], $isFloating);
+
+	}
+
+	/**
+	 * Sets the property as multiple date-time objects.
+	 *
+	 * The first value will be used as a reference for the timezones, and all
+	 * the otehr values will be adjusted for that timezone
+	 *
+	 * @param DateTimeInterface[] $dt
+	 * @param bool isFloating If set to true, timezones will be ignored.
+	 *
+	 * @return void
+	 */
+	public function setDateTimes(array $dt, $isFloating = false) {
+
+		$values = [];
+
+		if ($this->hasTime()) {
+
+			$tz = null;
+			$isUtc = false;
+
+			foreach ($dt as $d) {
+
+				if ($isFloating) {
+					$values[] = $d->format('Ymd\\THis');
+					continue;
+				}
+				if (is_null($tz)) {
+					$tz = $d->getTimeZone();
+					$isUtc = in_array($tz->getName(), ['UTC', 'GMT', 'Z', '+00:00']);
+					if (!$isUtc) {
+						$this->offsetSet('TZID', $tz->getName());
+					}
+				} else {
+					$d = $d->setTimeZone($tz);
+				}
+
+				if ($isUtc) {
+					$values[] = $d->format('Ymd\\THis\\Z');
+				} else {
+					$values[] = $d->format('Ymd\\THis');
+				}
+
+			}
+			if ($isUtc || $isFloating) {
+				$this->offsetUnset('TZID');
+			}
+
+		} else {
+
+			foreach ($dt as $d) {
+
+				$values[] = $d->format('Ymd');
+
+			}
+			$this->offsetUnset('TZID');
+
+		}
+
+		$this->value = $values;
+
+	}
+
+	/**
+	 * Returns the type of value.
+	 *
+	 * This corresponds to the VALUE= parameter. Every property also has a
+	 * 'default' valueType.
+	 *
+	 * @return string
+	 */
+	public function getValueType() {
+
+		return $this->hasTime() ? 'DATE-TIME' : 'DATE';
+
+	}
+
+	/**
+	 * Returns the value, in the format it should be encoded for JSON.
+	 *
+	 * This method must always return an array.
+	 *
+	 * @return array
+	 */
+	public function getJsonValue() {
+
+		$dts = $this->getDateTimes();
+		$hasTime = $this->hasTime();
+		$isFloating = $this->isFloating();
+
+		$tz = $dts[0]->getTimeZone();
+		$isUtc = $isFloating ? false : in_array($tz->getName(), ['UTC', 'GMT', 'Z']);
+
+		return array_map(
+			function(DateTimeInterface $dt) use ($hasTime, $isUtc) {
+
+				if ($hasTime) {
+					return $dt->format('Y-m-d\\TH:i:s') . ($isUtc ? 'Z' : '');
+				} else {
+					return $dt->format('Y-m-d');
+				}
+
+			},
+			$dts
+		);
+
+	}
+
+	/**
+	 * Sets the json value, as it would appear in a jCard or jCal object.
+	 *
+	 * The value must always be an array.
+	 *
+	 * @param array $value
+	 *
+	 * @return void
+	 */
+	public function setJsonValue(array $value) {
+
+		// dates and times in jCal have one difference to dates and times in
+		// iCalendar. In jCal date-parts are separated by dashes, and
+		// time-parts are separated by colons. It makes sense to just remove
+		// those.
+		$this->setValue(
+			array_map(
+				function($item) {
+
+					return strtr($item, [':' => '', '-' => '']);
+
+				},
+				$value
+			)
+		);
+
+	}
+
+	/**
+	 * We need to intercept offsetSet, because it may be used to alter the
+	 * VALUE from DATE-TIME to DATE or vice-versa.
+	 *
+	 * @param string $name
+	 * @param mixed $value
+	 *
+	 * @return void
+	 */
+	public function offsetSet($name, $value) {
+
+		parent::offsetSet($name, $value);
+		if (strtoupper($name) !== 'VALUE') {
+			return;
+		}
+
+		// This will ensure that dates are correctly encoded.
+		$this->setDateTimes($this->getDateTimes());
+
+	}
+
+	/**
+	 * Validates the node for correctness.
+	 *
+	 * The following options are supported:
+	 *   Node::REPAIR - May attempt to automatically repair the problem.
+	 *
+	 * This method returns an array with detected problems.
+	 * Every element has the following properties:
+	 *
+	 *  * level - problem level.
+	 *  * message - A human-readable string describing the issue.
+	 *  * node - A reference to the problematic node.
+	 *
+	 * The level means:
+	 *   1 - The issue was repaired (only happens if REPAIR was turned on)
+	 *   2 - An inconsequential issue
+	 *   3 - A severe issue.
+	 *
+	 * @param int $options
+	 *
+	 * @return array
+	 */
+	public function validate($options = 0) {
+
+		$messages = parent::validate($options);
+		$valueType = $this->getValueType();
+		$values = $this->getParts();
+		try {
+			foreach ($values as $value) {
+				switch ($valueType) {
+					case 'DATE' :
+						DateTimeParser::parseDate($value);
+						break;
+					case 'DATE-TIME' :
+						DateTimeParser::parseDateTime($value);
+						break;
+				}
+			}
+		} catch (InvalidDataException $e) {
+			$messages[] = [
+				'level'   => 3,
+				'message' => 'The supplied value (' . $value . ') is not a correct ' . $valueType,
+				'node'    => $this,
+			];
+		}
+		return $messages;
+
+	}
 }