/**
  * Parse an array of date and time objects with optional time zones. A new instance will be created for each object
  * if required.
  *
  * If the $dateTimes parameter is a DateTime zone instance, the instance will be returned and the $timezone
  * parameter is ignored. If the $dateTime parameter is anything other than a DateTime zone the date, time and the
  * time zone is parsed through the constructor.
  *
  * @param Array|DateTime|string|null $dateTimes [optional] An array of DateTime or PHPDateTime instance, the time
  *     as a string, or null to use the now() time. A single instance will be converted into an array. The array may
  *     be recursive.
  * @param Array|DateTimeZone|PHPDateTimeZone|string|DateTime|PHPDateTime|null $timezones [optional] An array of the
  *     time zones the specified date and times are in, or null to use the default time zones if the $time param
  *     isn't a DateTime instance. A DateTime or PHPDateTime instance to use it's timezone. The number of timezones
  *     must be equal to the number of date and time objects. If only one timezone is given the timezone will be
  *     used for all date and time objects. The array may be recursive.
  * @param bool $recursive [optional] True to recursively parse the array, false if not and leave recursive arrays
  *     the way they are.
  * @param bool $flat [optional] True to force the returned array to be flat, false to keep the same levels of the given array.
  * @param bool $all [optional] True to require all date time objects to be parsed successfully, false if not.
  * @param mixed|null $default [optional] The default value returned on failure. This object is also put in the
  *     array as results for objects that couldn't be parsed if $all is false.
  *
  * @return Array|mixed An array of DateTime instances or default values, or just the default value on failure.
  */
 public static function parseArray($dateTimes = null, $timezones = null, $recursive = true, $flat = false, $all = false, $default = null)
 {
     // Make sure sure the date and time and the timezone parameters are arrays
     if (!is_array($dateTimes)) {
         $dateTimes = array($dateTimes);
     }
     // Parse the timezones array, return the default value on failure
     if (($timezones = DateTimeZoneArrayUtils::parseArray($timezones, $all, $recursive, null)) === null) {
         return $default;
     }
     // Make sure the number of timezones is equal to one or the number of date and time objects
     $dateTimesCount = count($dateTimes);
     $timezonesCount = count($timezones);
     if ($timezonesCount != 1 && $timezonesCount != $dateTimesCount) {
         return $default;
     }
     // Parse each date and time
     foreach ($dateTimes as $key => &$value) {
         // Get the timezone for the current object
         $timezone = $timezonesCount > 1 ? $timezones[$key] : $timezones[0];
         // Make sure the object isn't an array by itself
         if (is_array($value)) {
             // Parse the array if recursive mode is enabled, return the default value on failure
             if ($recursive) {
                 // Make the array flat if required
                 if ($flat) {
                     array_splice($dateTimes, $key, 1, $value);
                 }
                 // Parse the value
                 if (($value = static::parseArray($value, $timezone, $recursive, $flat, $all, $default)) === $default && $all) {
                     return $default;
                 }
             }
             // Continue to the next element
             continue;
         }
         // Parse the current object, return the default value if the parsing failed while all objects must be parsed
         if (($value = DateTimeUtils::parse($value, $timezone, $default)) === $default && $all) {
             return $default;
         }
     }
     // Return the result
     return $dateTimes;
 }
Пример #2
0
 /**
  * Check whether a timezone is local relative to this timezone. This compares the offset of both timezones at a
  * specific point in time.
  *
  * @param DateTimeZone|PHPDateTimeZone|string|DateTime|PHPDateTime|null $timezone [optional] A DateTimeZone or
  *     PHPDateTimeZone instance, the timezone ID as a string, a DateTime or PHPDateTime instance to use it's
  *     timezone or null to use the defualt timezone.
  * @param DateTime|PHPDateTime|string|null $dateTime [optional] The specific point in date and time to compare the
  *     offsets at. A DateTime or PHPDateTime instance, the date and time as a string or null to use the now()
  *     value.
  *
  * @return bool True if the timezone is local, false if not. False will also be returned on failure.
  */
 public function isLocal($timezone = null, $dateTime = null)
 {
     // Parse the timezone, return false on failure
     if (($timezone = static::parse($timezone)) === null) {
         return false;
     }
     // Parse the date and time, return false on failure
     if (($dateTime = DateTimeUtils::parse($dateTime, $timezone, null)) === null) {
         return false;
     }
     // Compare the offsets of both timezones at the specific point in time, return the result
     return $this->getOffset($dateTime) == $timezone->getOffset($dateTime);
 }