Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JodaOrg/joda-money
Java library to represent monetary amounts.
https://github.com/JodaOrg/joda-money
java joda joda-money money
Last synced: 12 days ago
JSON representation
Java library to represent monetary amounts.
- Host: GitHub
- URL: https://github.com/JodaOrg/joda-money
- Owner: JodaOrg
- License: apache-2.0
- Created: 2011-05-10T14:55:09.000Z (over 13 years ago)
- Default Branch: main
- Last Pushed: 2024-10-12T22:10:47.000Z (about 1 month ago)
- Last Synced: 2024-10-29T22:37:26.897Z (15 days ago)
- Topics: java, joda, joda-money, money
- Language: Java
- Homepage: http://www.joda.org/joda-money/
- Size: 1020 KB
- Stars: 659
- Watchers: 26
- Forks: 118
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
Joda-Money
----------
Joda-Money provides a library of classes to store amounts of money.
Joda-Money does not provide, nor is it intended to provide, monetary algorithms beyond the most basic and obvious.
This is because the requirements for these algorithms vary widely between domains.
This library is intended to act as the base layer, providing classes that should be in the JDK.
As a flavour of Joda-Money, here's some example code:
```java
// create a monetary value
Money money = Money.parse("USD 23.87");
// add another amount with safe double conversion
CurrencyUnit usd = CurrencyUnit.of("USD");
money = money.plus(Money.of(usd, 12.43d));
// subtracts an amount in dollars
money = money.minusMajor(2);
// multiplies by 3.5 with rounding
money = money.multipliedBy(3.5d, RoundingMode.DOWN);
// compare two amounts
boolean bigAmount = money.isGreaterThan(dailyWage);
// convert to GBP using a supplied rate
BigDecimal conversionRate = ...; // obtained from code outside Joda-Money
Money moneyGBP = money.convertedTo(CurrencyUnit.GBP, conversionRate, RoundingMode.HALF_EVEN);
// use a BigMoney for more complex calculations where scale matters
BigMoney moneyCalc = money.toBigMoney();
```
Users are reminded that this software, like all open source software, is provided
on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND.
Joda-Money is licensed under the business-friendly [Apache 2.0 licence](https://www.joda.org/joda-money/licenses.html).
### Documentation
Various documentation is available:
* The [home page](https://www.joda.org/joda-money/)
* The helpful [user guide](https://www.joda.org/joda-money/userguide.html)
* The [Javadoc](https://www.joda.org/joda-money/apidocs/index.html)
* The change notes for the [releases](https://www.joda.org/joda-money/changes-report.html)
### Releases
The 2.x branch is compatible with Java SE 21 or later.
The 1.x branch is compatible with Java SE 8 or later.
v2.x releases are compatible with v1.x releases - except for the Java SE version and `module-info.class` file.
Joda-Money has no mandatory dependencies.
There is a *compile-time* dependency on [Joda-Convert](https://www.joda.org/joda-convert/),
but this is not required at runtime thanks to the magic of annotations.
Available in the [Maven Central repository](https://search.maven.org/search?q=g:org.joda%20AND%20a:joda-money&core=gav)
### For enterprise
Available as part of the Tidelift Subscription.
Joda and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
If you want the flexibility of open source and the confidence of commercial-grade software, this is for you.
[Learn more](https://tidelift.com/subscription/pkg/maven-org-joda-joda-money?utm_source=maven-org-joda-joda-money&utm_medium=github)
### Support
Please use [Stack Overflow](https://stackoverflow.com/questions/tagged/joda-money) for general usage questions.
GitHub [issues](https://github.com/JodaOrg/joda-money/issues) and [pull requests](https://github.com/JodaOrg/joda-money/pulls)
should be used when you want to help advance the project.
Any donations to support the project are accepted via [OpenCollective](https://opencollective.com/joda).
To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).
Tidelift will coordinate the fix and disclosure.
### Release process
* Update version (index.md, changes.xml)
* Commit and push
* Switch to Java 21
* `mvn clean release:clean release:prepare release:perform`
* `git fetch`
* Website will be built and released by GitHub Actions