Joda Time

Joda-Time is the widely used replacement for the Java date and time classes prior to Java SE 8.
Alternatives To Joda Time
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Dayjs44,1735,37111,4143 days ago122July 01, 2023808mitJavaScript
⏰ Day.js 2kB immutable date-time library alternative to Moment.js with the same modern API
Date Fns32,35968,28011,1583 days ago180April 30, 2023628mitTypeScript
⏳ Modern JavaScript date utility library ⌛️
Awesome Falsehood22,086
13 days ago4cc0-1.0
😱 Falsehoods Programmers Believe in
Luxon14,2601,9363,12114 days ago139March 04, 2023144mitJavaScript
⏱ A library for working with dates and times in JS
Arrow8,3723,7111,031a day ago63September 03, 202297apache-2.0Python
🏹 Better dates & times for Python
Pickadate.js7,727172383 months ago18May 31, 2019311mitJavaScript
The mobile-friendly, responsive, and lightweight jQuery date & time input picker.
6633 years ago13September 28, 2017118mitObjective-C
Dates and times made easy in iOS
Pendulum5,711540662a day ago53November 23, 2022229mitPython
Python datetimes made easy
Joda Time4,93631,2695,88314 days ago58March 30, 202344apache-2.0Java
Joda-Time is the widely used replacement for the Java date and time classes prior to Java SE 8.
Carbon3,479365 days ago112November 06, 20223mitGo
A simple, semantic and developer-friendly golang package for datetime
Alternatives To Joda Time
Select To Compare

Alternative Project Comparisons


Joda-Time provides a quality replacement for the Java date and time classes. The design allows for multiple calendar systems, while still providing a simple API. The 'default' calendar is the ISO8601 standard which is used by XML. The Gregorian, Julian, Buddhist, Coptic, Ethiopic and Islamic systems are also included. Supporting classes include time zone, duration, format and parsing.

Joda-time is no longer in active development except to keep timezone data up to date. From Java SE 8 onwards, users are asked to migrate to java.time (JSR-310) - a core part of the JDK which replaces this project. For Android users, java.time is added in API 26+. Projects needing to support lower API levels can use the ThreeTenABP library.

As a flavour of Joda-Time, here's some example code:

public boolean isAfterPayDay(DateTime datetime) {
  if (datetime.getMonthOfYear() == 2) {   // February is month 2!!
    return datetime.getDayOfMonth() > 26;
  return datetime.getDayOfMonth() > 28;

public Days daysToNewYear(LocalDate fromDate) {
  LocalDate newYear = fromDate.plusYears(1).withDayOfYear(1);
  return Days.daysBetween(fromDate, newYear);

public boolean isRentalOverdue(DateTime datetimeRented) {
  Period rentalPeriod = new Period().withDays(2).withHours(12);

public String getBirthMonthText(LocalDate dateOfBirth) {
  return dateOfBirth.monthOfYear().getAsText(Locale.ENGLISH);

Joda-Time is licensed under the business-friendly Apache 2.0 licence.

Tidelift dependency check CII Best Practices


Various documentation is available:


Release 2.12.5 is the current latest release. This release is considered stable and worthy of the 2.x tag. It depends on JDK 1.5 or later.

Available in the Maven Central repository

Maven configuration:


Gradle configuration:

compile 'joda-time:joda-time:2.12.5'

Related projects

Related projects at GitHub:

Other related projects:

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


Please use Stack Overflow for general usage questions. GitHub issues and pull requests should be used when you want to help advance the project.

Any donations to support the project are accepted via OpenCollective.

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Development and Contributions

Joda-Time is developed using standard GitHub tools. A checkstyle file is available, and PRs must comply with it. The project can be built using Apache Maven, such as mvn clean install. Continuous Integration takes place using GitHub Actions. Units tests are written in JUnit and run as part of the build and continuous integration. Changes via PR must include appropiate test coverage.

Note that Joda-Time is considered to be a largely finished project. No major enhancements are planned. If using Java SE 8, please migrate to java.time (JSR-310).

Release process

  • Update version (pom.xml,,, MANIFEST.MF, changes.xml)
  • Commit and push
  • Ensure on Java SE 8
  • mvn clean deploy -Doss.repo -Dgpg.passphrase=""
  • Website will be built and released by GitHub Actions
Popular Time Projects
Popular Date Projects
Popular Libraries Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Date Time