Click here for v1.x documentation.
Dinero.js
Dinero.js version

lessThan

boolean

Check whether the value of a Dinero object is lesser than another.

You can only compare objects that share the same currency. The function also normalizes objects to the same scale (the highest) before comparing them.

Copy linkParameters

NameTypeDescriptionRequired
dineroObjectDinero<TAmount>

The first Dinero object to compare.

Yes
comparatorDinero<TAmount>

The second Dinero object to compare.

Yes

Copy linkCode examples

Copy linkCompare two objects

import { dinero, lessThan } from 'dinero.js';
import { USD } from '@dinero.js/currencies';

const d1 = dinero({ amount: 800, currency: USD });
const d2 = dinero({ amount: 500, currency: USD });

lessThan(d1, d2); // false

Copy linkCompare two objects after normalization

import { dinero, lessThan } from 'dinero.js';
import { USD } from '@dinero.js/currencies';

const d1 = dinero({ amount: 5000, currency: USD, scale: 3 });
const d2 = dinero({ amount: 800, currency: USD });

lessThan(d1, d2); // true