class EasyRdf_Literal_Date in Zircon Profile 8

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

• class \EasyRdf_Literal
  • class \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

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

Name	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