Class: Chronos::Interval::Gregorian

Inherits:
Chronos::Interval show all
Defined in:
lib/chronos/interval/gregorian.rb

Overview

A Gregorian Interval extens Interval by months. Unlike in Gregorian Durations, months exactly defined in seconds (and therefore minutes, hours, days, weeks). Internally a gregorian interval is stored as total picoseconds after days + days between the two dates and additionally the months + days after months + picoseconds after days. For

Constant Summary collapse

ValidFixed = 
[:begin, :end].freeze

Constants inherited from Chronos::Interval

InspectFixedBegin, InspectFixedEnd

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Chronos::Interval

#+, #-, #days, #fixed_begin, #fixed_end, #format, #inspect, #picoseconds, #to_duration, #to_hash, #values_at

Constructor Details

#initialize(limit_a, limit_b, fixed = nil) ⇒ Gregorian

Returns a new instance of Gregorian.



36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
 
# File 'lib/chronos/interval/gregorian.rb', line 36

def initialize(limit_a, limit_b, fixed=nil)
	super(limit_a, limit_b, fixed)
	picoseconds       = @end.ps_number - @begin.ps_number if @begin.time?
	days, picoseconds = *picoseconds.divmod(PS_IN_DAY) if @begin.time?
	months            = 0
	
	if @begin.date? then
		a                 = Datetime.new(@begin.day_number, @begin.ps_number, ::Chronos::UTC)
		b                 = Datetime.new(@end.day_number,   @end.ps_number,   ::Chronos::UTC)
		days_after_months = days+b.day_of_month-a.day_of_month
		months            = b.year*12+b.month-a.year*12-a.month

		# move 1 month forward
		if days_after_months < 0 then
			days_after_months += a.days_in_month
			months            -= 1
		end

		days    += b.day_number - a.day_number
		bsd      = a.day_of_month > b.day_of_month ||
							 (start_date.time? && a.day_of_month == b.day_of_month && seconds < 0)
		month1   = a.year*12+a.month+(bsd ? 1 : 0)
		month2   = b.year*12+b.month
		months   = month2 - month1
		a2y,a2m  = *(month1-1).divmod(12)
		a, b     = Datetime.civil(a2y, a2m+1, 1), Datetime.civil(b.year, b.month, 1)
	
		seconds_in_months = (b.day_number-a.day_number)*86400
		p [seconds, seconds_in_months]
		seconds -= seconds_in_months
	
		b2y,b2m  = *(month1+(months.div(12)*12)).divmod(12)
		b        = Datetime.civil(b2y, b2m+1, 1)
		seconds_in_years = (b.day_number-a.day_number)*86400
	end
	
	@gregorian_duration = Duration::Gregorian.new(months, days+overflow, picoseconds, @language)
end

Instance Attribute Details

#begin ⇒ Object (readonly)

The smaller of the two datetimes



21
22
23
 
# File 'lib/chronos/interval/gregorian.rb', line 21

def begin
  @begin
end

#end ⇒ Object (readonly)

The bigger of the two datetimes



24
25
26
 
# File 'lib/chronos/interval/gregorian.rb', line 24

def end
  @end
end

#fixed ⇒ Object (readonly)

Which end is fixed, plays a role when adding, subtracting, multiplying, dividing, …



27
28
29
 
# File 'lib/chronos/interval/gregorian.rb', line 27

def fixed
  @fixed
end

Class Method Details

.between(limit_a, limit_b) ⇒ Object

unlike new, between always creates a positive interval it will switch limit_a and limit_b if limit_a > limit_b it always fixates :begin



32
33
34
 
# File 'lib/chronos/interval/gregorian.rb', line 32

def self.between(limit_a, limit_b)
	limit_a > limit_b ? new(limit_b, limit_a, false, :begin) : new(limit_a, limit_b, false, :begin)
end

Instance Method Details

#to_gregorian_duration ⇒ Object 



75
76
77
 
# File 'lib/chronos/interval/gregorian.rb', line 75

def to_gregorian_duration
	@gregorian_duration
end