www.aleph1.co.uk Git - yaffs-website/blob - vendor/easyrdf/easyrdf/lib/EasyRdf/Literal/DateTime.php

   1 <?php
   2
   3 /**
   4  * EasyRdf
   5  *
   6  * LICENSE
   7  *
   8  * Copyright (c) 2009-2013 Nicholas J Humfrey.  All rights reserved.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions are met:
  12  * 1. Redistributions of source code must retain the above copyright
  13  *    notice, this list of conditions and the following disclaimer.
  14  * 2. Redistributions in binary form must reproduce the above copyright notice,
  15  *    this list of conditions and the following disclaimer in the documentation
  16  *    and/or other materials provided with the distribution.
  17  * 3. The name of the author 'Nicholas J Humfrey" may be used to endorse or
  18  *    promote products derived from this software without specific prior
  19  *    written permission.
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  22  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  24  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  25  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  26  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  27  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  28  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  31  * POSSIBILITY OF SUCH DAMAGE.
  32  *
  33  * @package    EasyRdf
  34  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  35  * @license    http://www.opensource.org/licenses/bsd-license.php
  36  */
  37
  38 /**
  39  * Class that represents an RDF Literal of datatype xsd:dateTime
  40  *
  41  * @package    EasyRdf
  42  * @link       http://www.w3.org/TR/xmlschema-2/#date
  43  * @copyright  Copyright (c) 2009-2013 Nicholas J Humfrey
  44  * @license    http://www.opensource.org/licenses/bsd-license.php
  45  */
  46 class EasyRdf_Literal_DateTime extends EasyRdf_Literal_Date
  47 {
  48     /** Constructor for creating a new date and time literal
  49      *
  50      * If the value is a DateTime object, then it will be converted to the xsd:dateTime format.
  51      * If no value is given or is is null, then the current time is used.
  52      *
  53      * @see DateTime
  54      *
  55      * @param  mixed  $value     The value of the literal
  56      * @param  string $lang      Should be null (literals with a datatype can't have a language)
  57      * @param  string $datatype  Optional datatype (default 'xsd:dateTime')
  58      * @return object EasyRdf_Literal_DateTime
  59      */
  60     public function __construct($value = null, $lang = null, $datatype = null)
  61     {
  62         // If $value is null, use 'now'
  63         if (is_null($value)) {
  64             $value = new DateTime('now');
  65         }
  66
  67         // Convert DateTime objects into string
  68         if ($value instanceof DateTime) {
  69             $atom = $value->format(DateTime::ATOM);
  70             $value = preg_replace('/[\+\-]00(\:?)00$/', 'Z', $atom);
  71         }
  72
  73         EasyRdf_Literal::__construct($value, null, $datatype);
  74     }
  75
  76     /** Parses a string using DateTime and creates a new literal
  77      *
  78      * Example:
  79      *   $dt = EasyRdf_Literal_DateTime::parse('Mon 18 Jul 2011 18:45:43 BST');
  80      *
  81      * @see DateTime
  82      * @param string $value The date and time to parse
  83      * @return object EasyRdf_Literal_DateTime
  84      */
  85     public static function parse($value)
  86     {
  87         $value = new DateTime($value);
  88         return new EasyRdf_Literal_DateTime($value);
  89     }
  90
  91     /** 24-hour format of the hour as an integer
  92      *
  93      * @return integer
  94      */
  95     public function hour()
  96     {
  97         return (int)$this->format('H');
  98     }
  99
 100     /** The minutes pasts the hour as an integer
 101      *
 102      * @return integer
 103      */
 104     public function min()
 105     {
 106         return (int)$this->format('i');
 107     }
 108
 109     /** The seconds pasts the minute as an integer
 110      *
 111      * @return integer
 112      */
 113     public function sec()
 114     {
 115         return (int)$this->format('s');
 116     }
 117 }