Module: Periods::Modules::Period::InstanceMethods

Defined in:
lib/periods/modules/period.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#end_date ⇒ Date (readonly)

Returns the end date of this period.

Returns:

  • (Date) —

    the end date of this period.



20
21
22
 
# File 'lib/periods/modules/period.rb', line 20

def end_date
  @end_date
end

#start_date ⇒ Date (readonly)

Returns the start date of this period.

Returns:

  • (Date) —

    the start date of this period.



16
17
18
 
# File 'lib/periods/modules/period.rb', line 16

def start_date
  @start_date
end

Instance Method Details

#<=>(period) ⇒ Fixnum

Test whether the given period is older, newer or equal to this one.

Returns:

  • (Fixnum) —

    1 if period is older, -1 if newer, 0 if equal.

Since:

  • 0.0.3



61
62
63
64
65
66
67
68
69
 
# File 'lib/periods/modules/period.rb', line 61

def <=>(period)
  if start_date > period.start_date
    1
  elsif start_date < period.start_date
    -1
  else
    0
  end
end

#==(period) ⇒ Boolean

Test whether the given period is equal to this one. A period is considered equal if it has the same start and end date.

Examples:


period1 = Period.new('10.04.2015', '20.05.2015')
period2 = Period.new('10.04.2015', '20.05.2015')
period3 = Period.new('09.04.2015', '20.05.2015')
period1 == period2 # => true
period1 == period3 # => false

Returns:

  • (Boolean) —

    true if period is equal, false otherwise.

Since:

  • 0.0.3



50
51
52
 
# File 'lib/periods/modules/period.rb', line 50

def ==(period)
  start_date == period.start_date && end_date == period.end_date
end

#days ⇒ Fixnum

Returns number of days in period.

Examples:


Period.new('10.04.2015', '20.05.2015').days # => 41

Returns:

  • (Fixnum) —

    the number of days in period.

Since:

  • 0.0.3



118
119
120
 
# File 'lib/periods/modules/period.rb', line 118

def days
  end_date.yday - start_date.yday + 1
end

#end_year ⇒ Fixnum

Returns end year of period.

Examples:


Period.new('10.04.2015', '20.05.2016').end_year # => 2016

Returns:

  • (Fixnum) —

    end year of period.

Since:

  • 0.0.3



148
149
150
 
# File 'lib/periods/modules/period.rb', line 148

def end_year
  end_date.year
end

#include?(period) ⇒ Boolean

Test whether the given date or period is included in this one.

Examples:


Period.new('10.04.2015', '20.05.2015').include?('10.04.2015') # => true
Period.new('10.04.2015', '20.05.2015').include?('20.05.2015') # => true
Period.new('10.04.2015', '20.05.2015').include?('09.04.2015') # => false
Period.new('10.04.2015', '20.05.2015').include?('21.05.2015') # => false

Period.new('10.04.2015', '20.05.2015').include?(Period.new('10.04.2015', '20.05.2015')) # => true
Period.new('10.04.2015', '20.05.2015').include?(Period.new('15.04.2015', '15.05.2015')) # => true
Period.new('10.04.2015', '20.05.2015').include?(Period.new('09.04.2015', '20.05.2015')) # => false
Period.new('10.04.2015', '20.05.2015').include?(Period.new('10.04.2015', '21.05.2015')) # => false

Returns:

  • (Boolean) —

    true if date or period is included, false otherwise.

Since:

  • 0.0.3



171
172
173
174
175
176
177
178
179
180
181
182
 
# File 'lib/periods/modules/period.rb', line 171

def include?(period)
  if period.is_a?(Date)
    start_date <= period && period <= end_date
  elsif period.is_a?(String)
    date = Date.parse(period.to_s)
    start_date <= date && date <= end_date
  elsif period.is_a?(Period)
    start_date <= period.start_date && period.end_date <= end_date
  else
    false
  end
end

#initialize(start_date, end_date) ⇒ Object

Initialize a new period with its start and end date.

Examples:


period = Period.new('10.04.2015', '20.05.2015')


29
30
31
32
 
# File 'lib/periods/modules/period.rb', line 29

def initialize(start_date, end_date)
  @start_date = Date.parse(start_date.to_s)
  @end_date = Date.parse(end_date.to_s)
end

#next ⇒ Period

Returns next period.

Examples:


period = Period.new('10.04.2015', '20.05.2015')
period.next # => 21.05.2015 - 30.06.2015

Returns:

  • (Period) —

    the next period.

See Also:

  • Periods::Modules::Period#previous

Since:

  • 0.0.3



85
86
87
 
# File 'lib/periods/modules/period.rb', line 85

def next
  self.class.new(start_date + days, end_date + days)
end

#previous ⇒ Period

Returns previous period.

Examples:


period = Period.new('10.04.2015', '20.05.2015')
period.previous # => 28.02.2015 - 09.04.2015

Returns:

  • (Period) —

    the previous period.

See Also:

  • Periods::Modules::Period#next

Since:

  • 0.0.3



103
104
105
 
# File 'lib/periods/modules/period.rb', line 103

def previous
  self.class.new(start_date - days, end_date - days)
end

#start_year ⇒ Fixnum

Returns start year of period.

Examples:


Period.new('10.04.2015', '20.05.2016').start_year # => 2015

Returns:

  • (Fixnum) —

    start year of period.

Since:

  • 0.0.3



133
134
135
 
# File 'lib/periods/modules/period.rb', line 133

def start_year
  start_date.year
end

#to_s ⇒ String

Return string representation of period.

Examples:


Period.new('10.04.2015', '20.05.2015').to_s # => '10.04.2015 -  20.05.2015'

Returns:

  • (String) —

    the string representation of period.

Since:

  • 0.0.3



195
196
197
 
# File 'lib/periods/modules/period.rb', line 195

def to_s
  "#{start_date.strftime("%d.%m.%Y")} - #{end_date.strftime("%d.%m.%Y")}"
end