You are here

class EasyRdf_Literal_Date in Zircon Profile 8.0

Same name and namespace in other branches
  1. 8 vendor/easyrdf/easyrdf/lib/EasyRdf/Literal/Date.php \EasyRdf_Literal_Date

Class that represents an RDF Literal of datatype xsd:date

@package EasyRdf @link http://www.w3.org/TR/xmlschema-2/#date @copyright Copyright (c) 2009-2013 Nicholas J Humfrey @license http://www.opensource.org/licenses/bsd-license.php

Hierarchy

Expanded class hierarchy of EasyRdf_Literal_Date

1 string reference to 'EasyRdf_Literal_Date'
Literal.php in vendor/easyrdf/easyrdf/lib/EasyRdf/Literal.php

File

vendor/easyrdf/easyrdf/lib/EasyRdf/Literal/Date.php, line 46

View source
class EasyRdf_Literal_Date extends EasyRdf_Literal {

  /** Constructor for creating a new date literal
   *
   * If the value is a DateTime object, then it will be converted to the xsd:date format.
   * If no value is given or is is null, then the current date is used.
   *
   * @see DateTime
   *
   * @param  mixed  $value     The value of the literal
   * @param  string $lang      Should be null (literals with a datatype can't have a language)
   * @param  string $datatype  Optional datatype (default 'xsd:date')
   * @return object EasyRdf_Literal_Date
   */
  public function __construct($value = null, $lang = null, $datatype = null) {

    // If $value is null, use today's date
    if (is_null($value)) {
      $value = new DateTime('today');
    }

    // Convert DateTime object into string
    if ($value instanceof DateTime) {
      $value = $value
        ->format('Y-m-d');
    }
    parent::__construct($value, null, $datatype);
  }

  /** Parses a string using DateTime and creates a new literal
   *
   * Example:
   *   $date = EasyRdf_Literal_Date::parse('1 January 2011');
   *
   * @see DateTime
   * @param string $value The date to parse
   * @return object EasyRdf_Literal_Date
   */
  public static function parse($value) {
    $value = new DateTime($value);
    return new EasyRdf_Literal_Date($value);
  }

  /** Returns the date as a PHP DateTime object
   *
   * @see DateTime::format
   * @return string
   */
  public function getValue() {
    return new DateTime($this->value);
  }

  /** Returns date formatted according to given format
   *
   * @see DateTime::format
   * @param string $format
   * @return string
   */
  public function format($format) {
    return $this
      ->getValue()
      ->format($format);
  }

  /** A full integer representation of the year, 4 digits
   *
   * @return integer
   */
  public function year() {
    return (int) $this
      ->format('Y');
  }

  /** Integer representation of the month
   *
   * @return integer
   */
  public function month() {
    return (int) $this
      ->format('m');
  }

  /** Integer representation of the day of the month
   *
   * @return integer
   */
  public function day() {
    return (int) $this
      ->format('d');
  }

}

Members

Namesort descending Modifiers Type Description Overrides
EasyRdf_Literal::$classMap private static property @ignore A mapping from class name to datatype URI
EasyRdf_Literal::$datatype protected property @ignore The datatype URI of the literal
EasyRdf_Literal::$datatypeMap private static property @ignore a mapping from datatype uri to class name
EasyRdf_Literal::$lang protected property @ignore The language of the literal (e.g. 'en')
EasyRdf_Literal::$value protected property @ignore The string value for this literal
EasyRdf_Literal::create public static function Create a new literal object
EasyRdf_Literal::deleteDatatypeMapping public static function Remove the mapping between an RDF datatype and a PHP class name
EasyRdf_Literal::dumpValue public function Return pretty-print view of the literal
EasyRdf_Literal::getDatatype public function Returns the shortened datatype URI of the literal.
EasyRdf_Literal::getDatatypeForValue public static function Get datatype URI for a PHP value.
EasyRdf_Literal::getDatatypeUri public function Returns the full datatype URI of the literal.
EasyRdf_Literal::getLang public function Returns the language of the literal.
EasyRdf_Literal::setDatatypeMapping public static function Register an RDF datatype with a PHP class name
EasyRdf_Literal::toRdfPhp public function Returns the properties of the literal as an associative array
EasyRdf_Literal::__toString public function Magic method to return the value of a literal as a string
EasyRdf_Literal_Date::day public function Integer representation of the day of the month
EasyRdf_Literal_Date::format public function Returns date formatted according to given format
EasyRdf_Literal_Date::getValue public function Returns the date as a PHP DateTime object Overrides EasyRdf_Literal::getValue
EasyRdf_Literal_Date::month public function Integer representation of the month
EasyRdf_Literal_Date::parse public static function Parses a string using DateTime and creates a new literal 1
EasyRdf_Literal_Date::year public function A full integer representation of the year, 4 digits
EasyRdf_Literal_Date::__construct public function Constructor for creating a new date literal Overrides EasyRdf_Literal::__construct 1