commit	a82424d7e7047643a328721aa719b36a6fc964ea	[log] [tgz]
author	Android Build Coastguard Worker <[email protected]>	Fri Jan 10 13:57:16 2025 -0800
committer	Android Build Coastguard Worker <[email protected]>	Fri Jan 10 13:57:16 2025 -0800
tree	8855466fe08128b25467df82a6afc8f62bbb37c9
parent	a5d06173a3523985aa61b0049a88716a8f6a323b [diff]
parent	e608ace3a5ca43fe4312427e03fc8e074579deda [diff]

tree: 8855466fe08128b25467df82a6afc8f62bbb37c9

README.md

Overview

jISO8601 is yet another library made to parse dates in Java. It may still be useful since:

It's trivial to use
It's lightweight
It's compatible with Android
It can parse any date compatible with the norm

Getting started

There are only two public methods:

import fr.turri.jiso8601.*;
...
Calendar cal = Iso8601Deserializer.toCalendar("1985-03-04");
Date date = Iso8601Deserializer.toDate("1985-03-04T12:34:56Z");

Each type of ISO8601 dates are supported (calendar, ordinal and week dates, basic and extended format) as weel as each format of hour and timezone.

Installation

Using it with maven

This package will soon be available on maven central. For now it needs to be build from source. For instance, on Ubuntu:

git clone https://github.com/gturri/jiso8601
cd jiso8601
sudo apt-get install maven
mvn install

Then, in your pom.xml, add

<dependency>
    <groupId>fr.turri</groupId>
    <artifactId>jISO8601</artifactId>
    <version>0.1</version>
</dependency>

Out of scope (for now)

Recurring time interval and Periods aren't supported. Feel free to open feature requests.