Class: Puppet::Pops::Time::TimeData

Inherits:
Numeric
  • Object
show all
Includes:
LabelProvider
Defined in:
lib/puppet/pops/time/timespan.rb

Overview

TimeData is a Numeric that stores its value internally as nano-seconds but will be considered to be seconds and fractions of seconds when used in arithmetic or comparison with other Numeric types.

Direct Known Subclasses

Timespan, Timestamp

Constant Summary

Constants included from LabelProvider

LabelProvider::A, LabelProvider::AN, LabelProvider::SKIPPED_CHARACTERS, LabelProvider::VOWELS

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from LabelProvider

#a_an, #a_an_uc, #article, #combine_strings, #plural_s, #the, #the_uc

Constructor Details

#initialize(nanoseconds) ⇒ TimeData

Returns a new instance of TimeData.



32
33
34
 
# File 'lib/puppet/pops/time/timespan.rb', line 32

def initialize(nanoseconds)
  @nsecs = nanoseconds
end

Instance Attribute Details

#nsecs ⇒ Object (readonly)

Returns the value of attribute nsecs.



30
31
32
 
# File 'lib/puppet/pops/time/timespan.rb', line 30

def nsecs
  @nsecs
end

Instance Method Details

#<=>(o) ⇒ Object 



36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/puppet/pops/time/timespan.rb', line 36

def <=>(o)
  case o
  when self.class
    @nsecs <=> o.nsecs
  when Integer
    to_int <=> o
  when Float
    to_f <=> o
  else
    nil
  end
end

#label(o) ⇒ Object 



49
50
51
 
# File 'lib/puppet/pops/time/timespan.rb', line 49

def label(o)
  Utils.name_to_segments(o.class.name).last
end

#to_c ⇒ Complex

Returns short for ‘#to_f.to_c`.

Returns:

  • (Complex) —

    short for ‘#to_f.to_c`



68
69
70
 
# File 'lib/puppet/pops/time/timespan.rb', line 68

def to_c
  to_f.to_c
end

#to_f ⇒ Float

Returns the number of seconds.

Returns:

  • (Float) —

    the number of seconds



54
55
56
 
# File 'lib/puppet/pops/time/timespan.rb', line 54

def to_f
  @nsecs.fdiv(NSECS_PER_SEC)
end

#to_i ⇒ Object 



63
64
65
 
# File 'lib/puppet/pops/time/timespan.rb', line 63

def to_i
  to_int
end

#to_int ⇒ Integer

Returns the number of seconds with fraction part truncated.

Returns:

  • (Integer) —

    the number of seconds with fraction part truncated



59
60
61
 
# File 'lib/puppet/pops/time/timespan.rb', line 59

def to_int
  @nsecs / NSECS_PER_SEC
end

#to_r ⇒ Rational

Returns initial numerator is nano-seconds and denominator is nano-seconds per second.

Returns:

  • (Rational) —

    initial numerator is nano-seconds and denominator is nano-seconds per second



73
74
75
 
# File 'lib/puppet/pops/time/timespan.rb', line 73

def to_r
  Rational(@nsecs, NSECS_PER_SEC)
end