Home Reference Source Repository

Immutable data and time library for javascript

Build Status Coverage Status


Joda.js is a project that wants to bring joda time library to the javascript world. The Project is in a very early state. Be aware that the most of the things written here are not ready yet

Joda.js, a port of the Joda-Time immutable data and time library to javascript. It provides a simple and clean API based on the ISO8601 calendar. Joda-Time is the de facto standard date and time library for Java. From Java SE 8 it is part of the jdk at java.time (JSR-310).

Why yet another javascript date and time library

Getting started

The library is in a very early state, far away from productive. But you are very welcome to play around with Joda.js and to give your feedback. Please check the tests and the API Documentation for the current state of development.


Install joda using npm

npm install joda

Then require it to any module

var LocalDate = require('joda').LocalDate;

var d = LocalDate.parse('2012-12-24').atStartOfDay().plusMonths(2); // 2013-02-24T00:00:00


To use Joda.js from a browser, download either dist/joda.min.js or dist/joda.js (with sourcemaps for development)

Then add it as a script tag to your page

<script src="joda.min.js"></script>
    LocalDate = joda.LocalDate;
    var d = LocalDate.parse('2012-12-24').atStartOfDay().plusMonths(2); // 2013-02-24T00:00:00