Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/foal/gwt-time

Backport of functionality based on JSR-310 to GWT. This is NOT an implementation of JSR-310.
https://github.com/foal/gwt-time

gwt jsr-310 localdate localtime timezone

Last synced: 20 days ago
JSON representation

Backport of functionality based on JSR-310 to GWT. This is NOT an implementation of JSR-310.

Host: GitHub
URL: https://github.com/foal/gwt-time
Owner: foal
License: bsd-3-clause
Fork: true (ThreeTen/threetenbp)
Created: 2020-02-15T12:36:24.000Z (almost 5 years ago)
Default Branch: master
Last Pushed: 2024-05-19T05:02:05.000Z (7 months ago)
Last Synced: 2024-05-19T08:42:05.202Z (7 months ago)
Topics: gwt, jsr-310, localdate, localtime, timezone
Language: Java
Homepage:
Size: 41.7 MB
Stars: 19
Watchers: 7
Forks: 6
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
- Security: SECURITY.md

Awesome Lists containing this project

gwt-boot-awesome-lili - gwt-time - Library for Date and Time - Backport of functionality based (Date and Time)
gwt-boot-awesome-lili - gwt-time - Library for Date and Time - Backport of functionality based (Date and Time)

README

[![Maven Central](https://img.shields.io/maven-central/v/org.jresearch.gwt.time/org.jresearch.gwt.time)](https://mvnrepository.com/artifact/org.jresearch.gwt.time/org.jresearch.gwt.time)
[![Build](https://github.com/foal/gwt-time/actions/workflows/BuildSnapshot.yml/badge.svg)](https://github.com/foal/gwt-time/actions/workflows/BuildSnapshot.yml)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=foal_gwt-time&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=foal_gwt-time)

## GWT java.time emulation based on ThreeTen backport project
JSR-310 provides a new date and time library for Java SE 8.
This project is the port to GWT.

For more information of the base project see the [main home page](https://www.threeten.org/threetenbp/) of the project.

This project is NOT an implementation of JSR-310, as that would require
jumping through lots of unnecessary hoops.
Instead, this is a simple adaptation of "ThreeTen" backport intended to allow users to quickly use the JSR-310 API on GWT client side.
This project should be referred to using the "gwt-time" name and the base backport should be referred to using the "ThreeTen" name.

Active development on JSR-310 is at [OpenJDK](http://openjdk.java.net/):

That repository used the BSD 3-clause license as the base project.

Issues about the adaptation should be reported here at GitHub.
Pull requests and issues will only be considered so far as matching the behavior of the real Java SE. Additional requested features will be rejected.

### Time-zone data
Current version od TZDB: **2024agtz**
The time-zone database is stored as a pre-compiled dat file that is included in the built jar as a separate dependency. The actual time-zone data is located in the base project and updated manually.
To load TZDB data add the following dependency:
```xml

org.jresearch.gwt.time
org.jresearch.gwt.time.tzdb

```
Set the actual vesion for GWT 2.8.2/2.9.0/2.10.1/2.11.0

Add `` to your module.gwt.xml, if you use gwt-maven-plugin form Thomas Broyer (https://github.com/tbroyer/gwt-maven-plugin) it will be done automatically.

### Localization data
Current version of CLDR: **45**
By default the project supports base Java locales (constant from `java.util.Locale`). To enable all actulal locales (http://cldr.unicode.org) add the following dependency:
```xml

org.jresearch.gwt.locale
org.jresearch.gwt.locale.cldr
1.0.7

```
Check the actual version on project page: https://github.com/foal/gwt-locale-cldr

Add `` to your module.gwt.xml, if you use gwt-maven-plugin form Thomas Broyer (https://github.com/tbroyer/gwt-maven-plugin) it will be done automatically.

#### Time zone names
The impementation takes it from the browser with fallback to ZoneId from TZDB
#### Localized date/time parts (months, weekdays, eras, am/pm)
The impementation takes localized parts from the browser with falback to English.
#### Localized number formating (zero digit, positive sign, negative sign, decimal separator)
The impementation takes it from the browser with falback to `0`, `+`, `-` and `.`.
#### Date/Time formating
The impementation contains all actual data from CLDR

### Using
* For GWT 2.8.2 add the following project dependency to pom.xml
```xml

org.jresearch.gwt.time
org.jresearch.gwt.time
1.4.23

```
* For GWT 2.9.0/2.10.1/2.11.0 add the following project dependency to pom.xml
```xml

org.jresearch.gwt.time
org.jresearch.gwt.time
2.0.11

```
* Add `` to your module.gwt.xml, if you use gwt-maven-plugin form Thomas Broyer (https://github.com/tbroyer/gwt-maven-plugin) it will be done automatically.
* If you see the **AST compiler error** while using GWT 2.9.0/2.10.1/2.11.0 please disable the JVM asserts.
```

net.ltgt.gwt.maven
gwt-maven-plugin

test

false

```
It is an issue in GWT. More info - https://github.com/foal/gwt-time/issues/14 and https://github.com/gwtproject/gwt/issues/9694.

### Different setups for projects using gwt time
For more information about possible commbinations see [Different setups for projects using gwt time](https://github.com/foal/gwt-time/wiki/Different-setups-for-projects-using-gwt-time)

### Unimplemented or partial implemented features
* Compatibility with J2CL
* Updates from Java 10-14
* Localization for IsoFields.QUARTER_OF_YEAR (hard code English quarter text)
* Chronology prints as ID (take it from browser)
* Implementation of `JapaneseChronology`/`JapaneseEra`/`JapaneseDate` in the original project based on `java.util.Calendar` and doesn't works right now.
* new `JapaneseEra.REIWA` required Java 13 to build (current is Java 8)
* java.util.Locale emulation may clash with original GWT implementation. See [dicussion on Google Groups](https://groups.google.com/forum/#!msg/Google-Web-Toolkit/D0I1-Oao_V8/k5FEBrxNBQAJ) and similar [issue](https://github.com/gwtproject/gwt/issues/9682) with gwt-commons-lang3. Actual implementation are moved to separate project: https://github.com/foal/gwt-locale
* Convert to/from `java.util.Calendar`, to/from `java.util.TimeZone`, to/from `java.text.Format` is out of scope of this project

#### FAQs

1. What version of Java SE does this project map to?
This project currently maps to the contents of release Java 1.8

2. Will the backport be kept up to date?
There are no plans for further releases.
However if security issues or bugs are found, or pull requests received then a release may occur.

3. Is this project derived from OpenJDK?
No. This project is derived from the Reference Implementation previously hosted on GitHub.
That project had a BSD license, which has been preserved here.
Thus, this project is a fork of the fork of the original code before entry to OpenJDK.

### Releases
Available in the [Maven Central repository](https://search.maven.org/search?q=a:org.jresearch.gwt.time)

### Support
GitHub [issues](https://github.com/foal/gwt-time/issues) and [pull requests](https://github.com/foal/gwt-time/pulls)
should be used when you want to help advance the project.

Note that pull requests and issues will only be considered so far as matching the behavior of Java SE releases.
Additional requested features will be rejected.

Pull requests must _not_ be copied from the JDK, because the GPL license is incompatible with the BSD license used here.

### Building from sources
* check out [APT project](https://github.com/foal/gwt-time-apt) and INSTALL (`mvn clean install`) it.
* check out this project
* `mvn clean install`
* The project use the parent pom located on Sonatype snapshot repository.
```xml

oss.sonatype.org-snapshot
http://oss.sonatype.org/content/repositories/snapshots
false
true

```
or download directly https://oss.sonatype.org/content/repositories/snapshots/org/jresearch/org.jresearch.pom/29-SNAPSHOT/