Class: EDTF::Epoch

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Includes:
Comparable, Enumerable
Defined in:
lib/edtf/epoch.rb

Direct Known Subclasses

Century, Decade

Class Attribute Summary collapse

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(year = 0) ⇒ Epoch

Returns a new instance of Epoch.



25
26
27
 
# File 'lib/edtf/epoch.rb', line 25

def initialize(year = 0)
	self.year = year
end

Class Attribute Details

.duration ⇒ Object (readonly)

Returns the value of attribute duration.



10
11
12
 
# File 'lib/edtf/epoch.rb', line 10

def duration
  @duration
end

.format ⇒ Object (readonly)

Returns the value of attribute format.



10
11
12
 
# File 'lib/edtf/epoch.rb', line 10

def format
  @format
end

Instance Attribute Details

#year ⇒ Object Also known as: get

Returns the value of attribute year.



19
20
21
 
# File 'lib/edtf/epoch.rb', line 19

def year
  @year
end

Class Method Details

.current ⇒ Object 



12
13
14
 
# File 'lib/edtf/epoch.rb', line 12

def current
	new(Date.today.year)
end

Instance Method Details

#<=>(other) ⇒ Object 



42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/edtf/epoch.rb', line 42

def <=>(other)
	case other
	when Date
		cover?(other) ? 0 : to_date <=> other
	when Interval, Season
		[min, max] <=> [other.min, other.max]
	when Epoch
		[year, self.class.duration] <=> [other.year, other.class.duration]
	else
		nil
	end
rescue
	nil
end

#===(other) ⇒ Object 



57
58
59
60
61
 
# File 'lib/edtf/epoch.rb', line 57

def ===(other)
	(self <=> other) == 0
rescue
	false
end

#cover?(other) ⇒ Boolean

Returns:

  • (Boolean) 


36
37
38
39
40
 
# File 'lib/edtf/epoch.rb', line 36

def cover?(other)
	return false unless other.respond_to?(:day_precision)
	other = other.day_precision
	min.day_precision! <= other && other <= max.day_precision!
end

#each ⇒ Object 



63
64
65
66
67
68
69
 
# File 'lib/edtf/epoch.rb', line 63

def each
	if block_given?
		to_range.each(&Proc.new)
	else
		to_enum
	end
end

#edtf ⇒ Object Also known as: to_s 



85
86
87
 
# File 'lib/edtf/epoch.rb', line 85

def edtf
	self.class.format % (year / self.class.duration)
end

#max ⇒ Object 



77
78
79
 
# File 'lib/edtf/epoch.rb', line 77

def max
	to_date.advance(:years => self.class.duration - 1).end_of_year
end

#to_date ⇒ Object Also known as: min 



71
72
73
 
# File 'lib/edtf/epoch.rb', line 71

def to_date
	Date.new(year).year_precision!
end

#to_range ⇒ Object 



81
82
83
 
# File 'lib/edtf/epoch.rb', line 81

def to_range
	min..max
end