Class: Money
- Inherits:
-
Object
show all
- Extended by:
- Forwardable
- Includes:
- Comparable
- Defined in:
- lib/money/money.rb,
lib/money/errors.rb,
lib/money/helpers.rb,
lib/money/version.rb,
lib/money/currency.rb,
lib/money/allocator.rb,
lib/money/null_currency.rb,
lib/money/currency/loader.rb
Defined Under Namespace
Modules: Helpers
Classes: Allocator, Currency, Error, IncompatibleCurrencyError, NullCurrency, ReverseOperationProxy
Constant Summary
collapse
- NULL_CURRENCY =
NullCurrency.new.freeze
- VERSION =
"0.14.6"
Class Attribute Summary collapse
Instance Attribute Summary collapse
Class Method Summary
collapse
Instance Method Summary
collapse
Constructor Details
#initialize(value, currency) ⇒ Money
Returns a new instance of Money.
84
85
86
87
88
89
|
# File 'lib/money/money.rb', line 84
def initialize(value, currency)
raise ArgumentError if value.nan?
@currency = Helpers.value_to_currency(currency)
@value = value.round(@currency.minor_units)
freeze
end
|
Class Attribute Details
.default_currency ⇒ Object
Returns the value of attribute default_currency.
14
15
16
|
# File 'lib/money/money.rb', line 14
def default_currency
@default_currency
end
|
.parser ⇒ Object
Returns the value of attribute parser.
14
15
16
|
# File 'lib/money/money.rb', line 14
def parser
@parser
end
|
Instance Attribute Details
#currency ⇒ Object
Returns the value of attribute currency.
10
11
12
|
# File 'lib/money/money.rb', line 10
def currency
@currency
end
|
#value ⇒ Object
Returns the value of attribute value.
10
11
12
|
# File 'lib/money/money.rb', line 10
def value
@value
end
|
Class Method Details
.current_currency ⇒ Object
55
56
57
|
# File 'lib/money/money.rb', line 55
def current_currency
Thread.current[:money_currency]
end
|
.current_currency=(currency) ⇒ Object
59
60
61
|
# File 'lib/money/money.rb', line 59
def current_currency=(currency)
Thread.current[:money_currency] = currency
end
|
.default_settings ⇒ Object
.from_cents(cents, currency = nil) ⇒ Object
38
39
40
|
# File 'lib/money/money.rb', line 38
def from_cents(cents, currency = nil)
new(cents.round.to_f / 100, currency)
end
|
.from_subunits(subunits, currency_iso) ⇒ Object
42
43
44
45
46
|
# File 'lib/money/money.rb', line 42
def from_subunits(subunits, currency_iso)
currency = Helpers.value_to_currency(currency_iso)
value = Helpers.value_to_decimal(subunits) / currency.subunit_to_unit
new(value, currency)
end
|
.new(value = 0, currency = nil) ⇒ Object
Also known as:
from_amount
16
17
18
19
20
21
22
23
24
25
26
|
# File 'lib/money/money.rb', line 16
def new(value = 0, currency = nil)
value = Helpers.value_to_decimal(value)
currency = Helpers.value_to_currency(currency)
if value.zero?
@@zero_money ||= {}
@@zero_money[currency.iso_code] ||= super(Helpers::DECIMAL_ZERO, currency)
else
super(value, currency)
end
end
|
.parse(*args, **kwargs) ⇒ Object
34
35
36
|
# File 'lib/money/money.rb', line 34
def parse(*args, **kwargs)
parser.parse(*args, **kwargs)
end
|
.rational(money1, money2) ⇒ Object
48
49
50
51
52
53
|
# File 'lib/money/money.rb', line 48
def rational(money1, money2)
money1.send(:arithmetic, money2) do
factor = money1.currency.subunit_to_unit * money2.currency.subunit_to_unit
Rational((money1.value * factor).to_i, (money2.value * factor).to_i)
end
end
|
.with_currency(new_currency) ⇒ Object
Set Money.default_currency inside the supplied block, resets it to the previous value when done to prevent leaking state. Similar to I18n.with_locale and ActiveSupport’s Time.use_zone. This won’t affect instances being created with explicitly set currency.
.zero(currency = NULL_CURRENCY) ⇒ Object
Also known as:
empty
29
30
31
|
# File 'lib/money/money.rb', line 29
def zero(currency = NULL_CURRENCY)
new(0, currency)
end
|
Instance Method Details
#*(numeric) ⇒ Object
136
137
138
139
140
141
|
# File 'lib/money/money.rb', line 136
def *(numeric)
unless numeric.is_a?(Numeric)
Money.deprecate("Multiplying Money with #{numeric.class.name} is deprecated and will be removed in the next major release.")
end
Money.new(value.to_r * numeric, currency)
end
|
#+(other) ⇒ Object
124
125
126
127
128
|
# File 'lib/money/money.rb', line 124
def +(other)
arithmetic(other) do |money|
Money.new(value + money.value, calculated_currency(money.currency))
end
end
|
#-(other) ⇒ Object
130
131
132
133
134
|
# File 'lib/money/money.rb', line 130
def -(other)
arithmetic(other) do |money|
Money.new(value - money.value, calculated_currency(money.currency))
end
end
|
#-@ ⇒ Object
113
114
115
|
# File 'lib/money/money.rb', line 113
def -@
Money.new(-value, currency)
end
|
#/(numeric) ⇒ Object
143
144
145
|
# File 'lib/money/money.rb', line 143
def /(numeric)
raise "[Money] Dividing money objects can lose pennies. Use #split instead"
end
|
#<=>(other) ⇒ Object
117
118
119
120
121
122
|
# File 'lib/money/money.rb', line 117
def <=>(other)
return unless other.respond_to?(:to_money)
arithmetic(other) do |money|
value <=> money.value
end
end
|
#==(other) ⇒ Object
151
152
153
|
# File 'lib/money/money.rb', line 151
def ==(other)
eql?(other)
end
|
#abs ⇒ Object
241
242
243
|
# File 'lib/money/money.rb', line 241
def abs
Money.new(value.abs, currency)
end
|
#allocate(splits, strategy = :roundrobin) ⇒ Object
261
262
263
|
# File 'lib/money/money.rb', line 261
def allocate(splits, strategy = :roundrobin)
Money::Allocator.new(self).allocate(splits, strategy)
end
|
#allocate_max_amounts(maximums) ⇒ Object
266
267
268
|
# File 'lib/money/money.rb', line 266
def allocate_max_amounts(maximums)
Money::Allocator.new(self).allocate_max_amounts(maximums)
end
|
#as_json(*args) ⇒ Object
237
238
239
|
# File 'lib/money/money.rb', line 237
def as_json(*args)
to_s
end
|
#calculate_splits(num) ⇒ Hash<Money, Integer>
Calculate the splits evenly without losing pennies. Returns the number of high and low splits and the value of the high and low splits. Where high represents the Money value with the extra penny and low a Money without the extra penny.
293
294
295
296
297
298
299
300
301
302
303
304
305
|
# File 'lib/money/money.rb', line 293
def calculate_splits(num)
raise ArgumentError, "need at least one party" if num < 1
subunits = self.subunits
low = Money.from_subunits(subunits / num, currency)
high = Money.from_subunits(low.subunits + 1, currency)
num_high = subunits % num
{}.tap do |result|
result[high] = num_high if num_high > 0
result[low] = num - num_high
end
end
|
#cents ⇒ Object
100
101
102
103
|
# File 'lib/money/money.rb', line 100
def cents
(value * 100).to_i
end
|
#clamp(min, max) ⇒ Object
Clamps the value to be within the specified minimum and maximum. Returns self if the value is within bounds, otherwise a new Money object with the closest min or max value.
315
316
317
318
319
320
321
322
323
324
325
326
|
# File 'lib/money/money.rb', line 315
def clamp(min, max)
raise ArgumentError, 'min cannot be greater than max' if min > max
clamped_value = min if self.value < min
clamped_value = max if self.value > max
if clamped_value.nil?
self
else
Money.new(clamped_value, self.currency)
end
end
|
#coerce(other) ⇒ Object
186
187
188
189
|
# File 'lib/money/money.rb', line 186
def coerce(other)
raise TypeError, "Money can't be coerced into #{other.class}" unless other.is_a?(Numeric)
[ReverseOperationProxy.new(other), self]
end
|
#encode_with(coder) ⇒ Object
95
96
97
98
|
# File 'lib/money/money.rb', line 95
def encode_with(coder)
coder['value'] = @value.to_s('F')
coder['currency'] = @currency.iso_code
end
|
#eql?(other) ⇒ Boolean
TODO: Remove once cross-currency mathematical operations are no longer allowed
156
157
158
159
160
|
# File 'lib/money/money.rb', line 156
def eql?(other)
return false unless other.is_a?(Money)
return false unless currency.compatible?(other.currency)
value == other.value
end
|
#floor ⇒ Object
245
246
247
|
# File 'lib/money/money.rb', line 245
def floor
Money.new(value.floor, currency)
end
|
#fraction(rate) ⇒ Object
253
254
255
256
257
258
|
# File 'lib/money/money.rb', line 253
def fraction(rate)
raise ArgumentError, "rate should be positive" if rate < 0
result = value / (1 + rate)
Money.new(result, currency)
end
|
#init_with(coder) ⇒ Object
91
92
93
|
# File 'lib/money/money.rb', line 91
def init_with(coder)
initialize(Helpers.value_to_decimal(coder['value']), coder['currency'])
end
|
#inspect ⇒ Object
147
148
149
|
# File 'lib/money/money.rb', line 147
def inspect
"#<#{self.class} value:#{self} currency:#{self.currency}>"
end
|
#no_currency? ⇒ Boolean
109
110
111
|
# File 'lib/money/money.rb', line 109
def no_currency?
currency.is_a?(NullCurrency)
end
|
#round(ndigits = 0) ⇒ Object
249
250
251
|
# File 'lib/money/money.rb', line 249
def round(ndigits=0)
Money.new(value.round(ndigits), currency)
end
|
Split money amongst parties evenly without losing pennies.
278
279
280
|
# File 'lib/money/money.rb', line 278
def split(num)
calculate_splits(num).sum([]) { |value, count| Array.new(count, value) }
end
|
#subunits ⇒ Object
105
106
107
|
# File 'lib/money/money.rb', line 105
def subunits
(@value * @currency.subunit_to_unit).to_i
end
|
#to_d ⇒ Object
205
206
207
|
# File 'lib/money/money.rb', line 205
def to_d
value
end
|
#to_json(options = {}) ⇒ Object
233
234
235
|
# File 'lib/money/money.rb', line 233
def to_json(options = {})
to_s
end
|
#to_liquid ⇒ Object
229
230
231
|
# File 'lib/money/money.rb', line 229
def to_liquid
cents
end
|
#to_money(curr = nil) ⇒ Object
191
192
193
194
195
196
197
198
199
200
201
202
203
|
# File 'lib/money/money.rb', line 191
def to_money(curr = nil)
if !curr.nil? && no_currency?
return Money.new(value, curr)
end
curr = Helpers.value_to_currency(curr)
unless currency.compatible?(curr)
Money.deprecate("mathematical operation not permitted for Money objects with different currencies #{curr} and #{currency}. " \
"A Money::IncompatibleCurrencyError will raise in the next major release")
end
self
end
|
#to_s(style = nil) ⇒ Object
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
# File 'lib/money/money.rb', line 209
def to_s(style = nil)
units = case style
when :legacy_dollars
2
when :amount, nil
currency.minor_units
else
raise ArgumentError, "Unexpected style: #{style}"
end
rounded_value = value.round(units)
if units == 0
sprintf("%d", rounded_value)
else
sign = rounded_value < 0 ? '-' : ''
rounded_value = rounded_value.abs
sprintf("%s%d.%0#{units}d", sign, rounded_value.truncate, rounded_value.frac * (10 ** units))
end
end
|