Class: RDF::Literal::Date

Inherits:

Temporal

Object
RDF::Literal
Temporal
RDF::Literal::Date

show all

Defined in:: vendor/bundler/ruby/3.3.0/bundler/gems/rdf-884e3ef78084/lib/rdf/model/literal/date.rb

Overview

A date literal.

Direct Known Subclasses

Day, Month, MonthDay, Year, YearMonth

Constant Summary collapse

DATATYPE = Since: 0.2.1

RDF::URI("http://www.w3.org/2001/XMLSchema#date")

GRAMMAR = Since: 0.2.1

%r(\A(#{YEARFRAG}-#{MONTHFRAG}-#{DAYFRAG})(#{TZFRAG})?\z).freeze

FORMAT = Since: 0.2.1

'%Y-%m-%d'.freeze

Instance Attribute Summary

Attributes inherited from RDF::Literal

#datatype, #direction, #language

Instance Method Summary collapse

#humanize(lang = :en) ⇒ String
Returns a human-readable value for the literal.
#initialize(value, datatype: nil, lexical: nil, **options) ⇒ Date constructor
Internally, a Date is represented using a native ::DateTime object at midnight.

Methods inherited from Temporal

#+, #-, #<=>, #==, #adjust_to_timezone, #adjust_to_timezone!, #canonicalize!, #day, #hours, #milliseconds?, #minutes, #month, #seconds, #timezone, #timezone?, #to_s, #tz, #valid?, #year

Methods inherited from RDF::Literal

#<=>, #==, #as_datetime, #as_number, #canonicalize!, #compatible?, #comperable_datatype2?, #comperable_datatype?, #datatype?, #direction?, #english?, #eql?, #escape, #hash, #inspect, #language?, #literal?, #method_missing, #object, #plain?, #respond_to_missing?, #simple?, #squish, #squish!, #to_s, #valid?, #valid_extended?, #validate!, #value, #value_hash

Methods included from Term

#<=>, #==, #aggregate?, #as_datetime, #as_number, #compatible?, #eql?, #escape, #evaluate, #ndvars, #optimize, #sameTerm?, #term?, #terms, #to_base, #to_sparql, #to_term, #vars

Methods included from SPARQL::Algebra::Expression

cast, #constant?, #evaluate, extension, extension?, extensions, for, #invalid?, new, #node?, open, #optimize, #optimize!, parse, register_extension, #to_sxp_bin, #valid?, #validate!, #variable?

Methods included from Util::Logger

#log_debug, #log_depth, #log_error, #log_fatal, #log_info, #log_recover, #log_recovering?, #log_statistics, #log_warn, #logger

Methods included from Value

#anonymous?, #canonicalize, #canonicalize!, #constant?, #formula?, #graph?, #inspect, #inspect!, #invalid?, #iri?, #list?, #literal?, #node?, #resource?, #start_with?, #statement?, #term?, #to_ndvar, #to_nquads, #to_ntriples, #to_rdf, #to_term, #type_error, #uri?, #valid?, #validate!, #variable?

Constructor Details

#initialize(value, datatype: nil, lexical: nil, **options) ⇒ `Date`

Note:

If initialized using the #to_datetime method, time component is unchanged. Otherewise, it is set to 00:00 (midnight).

Internally, a Date is represented using a native ::DateTime object at midnight. If initialized from a ::Date, there is no timezone component, If initialized from a ::DateTime, the timezone is taken from that native object, otherwise, a timezone (or no timezone) is taken from the string representation having a matching zzzzzz component.

Parameters:

value (String, Date, #to_datetime)
value (Object)
direction (Symbol) —
(nil) Initial text direction.
language (Symbol) —
(nil) Language is downcased to ensure proper matching
lexical (String) (defaults to: nil) —
(nil) Supplied lexical representation of this literal, otherwise it comes from transforming value to a string form..
datatype (URI) (defaults to: nil) —
(nil)
validate (Boolean) —
(false)
canonicalize (Boolean) —
(false)

Since:

0.2.1

# File 'vendor/bundler/ruby/3.3.0/bundler/gems/rdf-884e3ef78084/lib/rdf/model/literal/date.rb', line 20

def initialize(value, datatype: nil, lexical: nil, **options)
  @datatype = RDF::URI(datatype || self.class.const_get(:DATATYPE))
  @string   = lexical || (value if value.is_a?(String))
  @object   = case
    when value.class == ::Date
      @zone = nil
      # Use midnight as midpoint of the interval
      ::DateTime.parse(value.strftime('%FT00:00:00'))
    when value.respond_to?(:to_datetime)
      value.to_datetime
    else
      md = value.to_s.match(GRAMMAR)
      _, dt, tz = Array(md)
      if tz
        @zone = tz == 'Z' ? '+00:00' : tz
      else
        @zone = nil # No timezone
      end
      # Use midnight as midpoint of the interval
      ::DateTime.parse("#{dt}T00:00:00#{@zone}")
  end rescue ::DateTime.new
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class RDF::Literal

Instance Method Details

#humanize(lang = :en) ⇒ `String`

Returns a human-readable value for the literal

Returns:

(String)