This class is important to handle XMLRPC dateTime.iso8601 values, correcly, because normal UNIX-dates, ie: Date, only handle dates from year 1970 on, and ruby's native Time class handles dates without the time component.

XMLRPC::DateTime is able to store a XMLRPC dateTime.iso8601 value correctly.

Methods
#
D
H
M
N
S
T
Y
Attributes
[R] day

Return the value of the specified date/time component.
[R] hour

Return the value of the specified date/time component.
[R] min

Return the value of the specified date/time component.
[R] mon

Return the value of the specified date/time component.
[R] month

Return the value of the specified date/time component.
[R] sec

Return the value of the specified date/time component.
[R] year

Return the value of the specified date/time component.
Class Public methods
new(year, month, day, hour, min, sec)

Creates a new XMLRPC::DateTime instance with the parameters year, month, day as date and hour, min, sec as time.

Raises an ArgumentError if a parameter is out of range, or if year is not of the Integer type.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 83
def initialize(year, month, day, hour, min, sec)
  self.year, self.month, self.day = year, month, day
  self.hour, self.min, self.sec   = hour, min, sec
end
Instance Public methods
==(o)

Returns whether or not all date/time components are an array.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 116
def ==(o)
  self.to_a == Array(o) rescue false
end
day=(value)

Set value as the new date/time component.

Raises an ArgumentError if the given value isn't between 1 and 31.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 42
def day= (value)
  raise ArgumentError, "date/time out of range" unless (1..31).include? value
  @day = value
end
hour=(value)

Set value as the new date/time component.

Raises an ArgumentError if the given value isn't between 0 and 24.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 50
def hour= (value)
  raise ArgumentError, "date/time out of range" unless (0..24).include? value
  @hour = value
end
min=(value)

Set value as the new date/time component.

Raises an ArgumentError if the given value isn't between 0 and 59.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 58
def min= (value)
  raise ArgumentError, "date/time out of range" unless (0..59).include? value
  @min = value
end
mon=(value)

Alias for #month=.

Alias for: month=
month=(value)

Set value as the new date/time component.

Raises an ArgumentError if the given value isn't between 1 and 12.

Also aliased as: mon=

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 34
def month= (value)
  raise ArgumentError, "date/time out of range" unless (1..12).include? value
  @month = value
end
sec=(value)

Set value as the new date/time component.

Raises an ArgumentError if the given value isn't between 0 and 59.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 66
def sec= (value)
  raise ArgumentError, "date/time out of range" unless (0..59).include? value
  @sec = value
end
to_a()

Returns all date/time components in an array.

Returns +[year, month, day, hour, min, sec]+.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 111
def to_a
  [@year, @month, @day, @hour, @min, @sec]
end
to_date()

Return a Date object of the date which represents self.

The Date object do not contain the time component (only date).

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 104
def to_date
  Date.new(*to_a[0,3])
end
to_time()

Return a Time object of the date/time which represents self. If the @year is below 1970, this method returns nil, because Time cannot handle years below 1970.

The timezone used is GMT.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 93
def to_time
  if @year >= 1970
    Time.gm(*to_a)
  else
    nil
  end
end
year=(value)

Set value as the new date/time component.

Raises ArgumentError if the given value is out of range, or in the case of #year= if value is not of type Integer.

Source: show | on GitHub 

# File lib/xmlrpc/datetime.rb, line 26
def year= (value)
  raise ArgumentError, "date/time out of range" unless value.is_a? Integer
  @year = value
end