# JodaOrg/joda-time

Joda-Time is the widely used replacement for the Java date and time classes prior to Java SE 8.

Repository: https://github.com/JodaOrg/joda-time
Canonical: https://ross.abutalabs.com/products/joda-time
Homepage: http://www.joda.org/joda-time/
Language: Java
License: Apache-2.0
License Family: permissive
Topics: java, joda, joda-time, date-time
Last push: 2026-07-26T13:33:54+00:00

## Health v2 (maintenance only)
Score: 91/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 94, release rhythm 83, longevity 100
- inputs: {"age_days": 5588, "days_push": 38, "days_rel": 38, "gap_med": 88, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4979, forks 1022 (observed 2026-08-28T04:09:04.150555+00:00)

## What it is
Joda-Time is a quality date and time library for Java, serving as the de facto standard replacement for the poor JDK date/time classes prior to Java SE 8. It provides immutable, thread-safe classes like DateTime, LocalDate, and Period, supports multiple calendar systems, and is now in maintenance mode with users encouraged to migrate to java.time (JSR-310).

## Use cases
- handle dates and times in Java before JDK 8
- work with multiple calendar systems like Buddhist or Islamic
- calculate differences between two dates
- format and parse dates with time zones
- represent dates without time or times without dates
- handle daylight savings transitions correctly
- support date/time on older Android API levels

## When to choose
- maintaining legacy Java codebases predating Java SE 8
- needing calendar systems beyond Gregorian (Buddhist, Coptic, Ethiopic, Islamic)
- supporting Android API levels below 26 where java.time is unavailable
- requiring a proven, stable, thread-safe date/time API

## When to avoid
- starting a new project on Java SE 8 or later (use java.time instead)
- targeting Android API 26+ (use built-in java.time)
- needing active development or new features (project is maintenance-only)
- willing to use ThreeTenABP backport on older Android

## Facets
- artifact type: library
- maturity: maintenance
- function: date-time, parser, internationalization
- domain: developer-tools, cross-platform
- platform: jvm
- tags: date-and-time, calendar-systems, timezone, immutable, thread-safe, java-8-predecessor, android

## Member repositories
- JodaOrg/joda-time (main) score 91

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:04.150555+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:17:42.360965+00:00, confidence not recorded.
  - readme: https://github.com/JodaOrg/joda-time (fetched 2026-08-28T04:09:04.150555+00:00, sha 10cb50a67c3b)
  - homepage: http://www.joda.org/joda-time/ (fetched 2026-08-29T08:58:58.133882+00:00, sha a91d7d7668ff)
  - site_page: https://www.joda.org/joda-time/quickstart.html (fetched 2026-08-29T08:58:58.158248+00:00, sha 60477e859ccb)
  - site_page: https://www.joda.org/joda-time/apidocs/index.html (fetched 2026-08-29T08:58:58.162683+00:00, sha b20bd591bec0)
  - site_page: https://www.joda.org/joda-time/installation.html (fetched 2026-08-29T08:58:58.164849+00:00, sha eefc65c66ad0)
  - site_page: https://www.joda.org/joda-time/apidocs/org/joda/time/DateTime.html (fetched 2026-08-29T08:58:58.166999+00:00, sha 2f8430cbcbb0)
  - site_page: https://www.joda.org/joda-time/apidocs/org/joda/time/Days.html (fetched 2026-08-29T08:58:58.170017+00:00, sha a2cf3fb4bb0f)
  - site_page: https://www.joda.org/joda-time/apidocs/org/joda/time/LocalDate.html (fetched 2026-08-29T08:58:58.171981+00:00, sha e34cee117dae)
  - site_page: https://www.joda.org/joda-time/apidocs/org/joda/time/Period.html (fetched 2026-08-29T08:58:58.174741+00:00, sha 6e8dc0f6fa8c)
  - site_page: https://www.joda.org/joda-time/faq.html (fetched 2026-08-29T08:58:58.160638+00:00, sha 055c607034f5)
- Data as of 2026-08-30T08:39:29.467469+00:00.