/usr/share/php/Horde/Date/Span.php is in php-horde-date 2.4.1-1ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 | <?php
/**
* Copyright 2009-2017 Horde LLC (http://www.horde.org/)
*
* See the enclosed file COPYING for license information (LGPL). If you
* did not receive this file, see http://www.horde.org/licenses/lgpl21.
*
* @author Chuck Hagenbuch <chuck@horde.org>
* @category Horde
* @license http://www.horde.org/licenses/lgpl21 LGPL
* @package Date
*/
/**
* A Span represents a range of time.
*
* @author Chuck Hagenbuch <chuck@horde.org>
* @category Horde
* @copyright 2009-2017 Horde LLC
* @license http://www.horde.org/licenses/lgpl21 LGPL
* @package Date
*/
class Horde_Date_Span
{
/**
* @var Horde_Date
*/
public $begin;
/**
* @var Horde_Date
*/
public $end;
/**
* Constructor.
*
* @param mixed $begin Horde_Date or other format accepted by the
* Horde_Date constructor.
* @param mixed $end Horde_Date or other format accepted by the
* Horde_Date constructor.
*/
public function __construct($begin, $end)
{
if (!($begin instanceof Horde_Date)) {
$begin = new Horde_Date($begin);
}
if (!($end instanceof Horde_Date)) {
$end = new Horde_Date($end);
}
$this->begin = $begin;
$this->end = $end;
}
/**
* Returns the width of this span in seconds.
*/
public function width()
{
return abs($this->end->timestamp() - $this->begin->timestamp());
}
/**
* Is a Horde_Date within this span?
*
* @param Horde_Date $date
*/
public function includes($date)
{
return ($this->begin->compareDateTime($date) <= 0) && ($this->end->compareDateTime($date) >= 0);
}
/**
* Add a number of seconds to this span, returning the new span
*/
public function add($factor)
{
return new Horde_Date_Span($this->begin->add($factor), $this->end->add($factor));
}
/**
* Subtract a number of seconds from this span, returning the new span.
*/
public function sub($factor)
{
return new Horde_Date_Span($this->begin->sub($factor), $this->end->sub($factor));
}
public function __toString()
{
return '(' . $this->begin . '..' . $this->end . ')';
}
}
|