{"id":21444896,"url":"https://github.com/foal/gwt-time","last_synced_at":"2025-07-14T18:31:56.520Z","repository":{"id":43476056,"uuid":"240708009","full_name":"foal/gwt-time","owner":"foal","description":"Backport of functionality based on JSR-310 to GWT. This is NOT an implementation of JSR-310.","archived":false,"fork":true,"pushed_at":"2024-05-19T05:02:05.000Z","size":43745,"stargazers_count":19,"open_issues_count":1,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-05-19T08:42:05.202Z","etag":null,"topics":["gwt","jsr-310","localdate","localtime","timezone"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"ThreeTen/threetenbp","license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/foal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null}},"created_at":"2020-02-15T12:36:24.000Z","updated_at":"2024-05-18T15:08:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/foal/gwt-time","commit_stats":null,"previous_names":[],"tags_count":65,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foal%2Fgwt-time","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foal%2Fgwt-time/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foal%2Fgwt-time/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/foal%2Fgwt-time/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/foal","download_url":"https://codeload.github.com/foal/gwt-time/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225991830,"owners_count":17556371,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gwt","jsr-310","localdate","localtime","timezone"],"created_at":"2024-11-23T02:22:07.909Z","updated_at":"2024-11-23T02:22:16.572Z","avatar_url":"https://github.com/foal.png","language":"Java","funding_links":[],"categories":["Date and Time"],"sub_categories":[],"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)\n[![Build](https://github.com/foal/gwt-time/actions/workflows/BuildSnapshot.yml/badge.svg)](https://github.com/foal/gwt-time/actions/workflows/BuildSnapshot.yml)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=foal_gwt-time\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=foal_gwt-time)\n\n## GWT java.time emulation based on ThreeTen backport project\nJSR-310 provides a new date and time library for Java SE 8.\nThis project is the port to GWT.\n\nFor more information of the base project see the [main home page](https://www.threeten.org/threetenbp/) of the project.\n\nThis project is NOT an implementation of JSR-310, as that would require\njumping through lots of unnecessary hoops.\nInstead, this is a simple adaptation of \"ThreeTen\" backport intended to allow users to quickly use the JSR-310 API on GWT client side.\nThis project should be referred to using the \"gwt-time\" name and the base backport should be referred to using the \"ThreeTen\" name.\n\nActive development on JSR-310 is at [OpenJDK](http://openjdk.java.net/):\n\nThat repository used the BSD 3-clause license as the base project.\n\nIssues about the adaptation should be reported here at GitHub.\nPull requests and issues will only be considered so far as matching the behavior of the real Java SE. Additional requested features will be rejected.\n\n### Time-zone data\nCurrent version od TZDB: **2024agtz**\nThe 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.\nTo load TZDB data add the following dependency:\n```xml\n\u003cdependency\u003e\n\t\u003cgroupId\u003eorg.jresearch.gwt.time\u003c/groupId\u003e\n\t\u003cartifactId\u003eorg.jresearch.gwt.time.tzdb\u003c/artifactId\u003e\n\u003c/dependency\u003e\n```\nSet the actual vesion for GWT 2.8.2/2.9.0/2.10.1/2.11.0  \n\nAdd `\u003cinherits name=\"org.jresearch.threetenbp.gwt.tzdb.module\"/\u003e` 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.\n\n### Localization data\nCurrent version of CLDR: **45**\nBy 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:\n```xml\n\u003cdependency\u003e\n\t\u003cgroupId\u003eorg.jresearch.gwt.locale\u003c/groupId\u003e\n\t\u003cartifactId\u003eorg.jresearch.gwt.locale.cldr\u003c/artifactId\u003e\n\t\u003cversion\u003e1.0.7\u003c/version\u003e\n\u003c/dependency\u003e\n```\nCheck the actual version on project page: https://github.com/foal/gwt-locale-cldr\n\nAdd `\u003cinherits name=\"org.jresearch.gwt.locale.cldr.module\"/\u003e` 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.\n\n#### Time zone names\nThe impementation takes it from the browser with fallback to ZoneId from TZDB\n#### Localized date/time parts (months, weekdays, eras, am/pm)\nThe impementation takes localized parts from the browser with falback to English.\n#### Localized number formating (zero digit, positive sign, negative sign, decimal separator)\nThe impementation takes it from the browser with falback to `0`, `+`, `-` and `.`.\n#### Date/Time formating\nThe impementation contains all actual data from CLDR \n\n### Using\n* For GWT 2.8.2 add the following project dependency to pom.xml\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jresearch.gwt.time\u003c/groupId\u003e\n    \u003cartifactId\u003eorg.jresearch.gwt.time\u003c/artifactId\u003e\n    \u003cversion\u003e1.4.23\u003c/version\u003e\n\u003c/dependency\u003e\n```\n* For GWT 2.9.0/2.10.1/2.11.0 add the following  project dependency to pom.xml\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003eorg.jresearch.gwt.time\u003c/groupId\u003e\n    \u003cartifactId\u003eorg.jresearch.gwt.time\u003c/artifactId\u003e\n    \u003cversion\u003e2.0.11\u003c/version\u003e\n\u003c/dependency\u003e\n```\n* Add `\u003cinherits name=\"org.jresearch.threetenbp.gwt.time.module\"/\u003e` 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.\n* If you see the **AST compiler error** while using GWT 2.9.0/2.10.1/2.11.0 please disable the JVM asserts. \n```\n      \u003cplugin\u003e\n        \u003cgroupId\u003enet.ltgt.gwt.maven\u003c/groupId\u003e\n        \u003cartifactId\u003egwt-maven-plugin\u003c/artifactId\u003e\n        \u003cexecutions\u003e\n          \u003cexecution\u003e\n            \u003cgoals\u003e\n              \u003cgoal\u003etest\u003c/goal\u003e\n            \u003c/goals\u003e\n            \u003cconfiguration\u003e\n              \u003c!-- disable JVM asserts --\u003e\n              \u003cenableAssertions\u003efalse\u003c/enableAssertions\u003e\n            \u003c/configuration\u003e\n          \u003c/execution\u003e\n        \u003c/executions\u003e\n      \u003c/plugin\u003e\n```\nIt is an issue in GWT. More info - https://github.com/foal/gwt-time/issues/14 and https://github.com/gwtproject/gwt/issues/9694.\n\n### Different setups for projects using gwt time\nFor 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)\n\n### Unimplemented or partial implemented features\n* Compatibility with J2CL\n* Updates from Java 10-14\n* Localization for IsoFields.QUARTER_OF_YEAR (hard code English quarter text)\n* Chronology prints as ID (take it from browser)\n* Implementation of `JapaneseChronology`/`JapaneseEra`/`JapaneseDate` in the original project based on `java.util.Calendar` and doesn't works right now.\n* new `JapaneseEra.REIWA` required Java 13 to build (current is Java 8)\n* 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\n* Convert to/from `java.util.Calendar`, to/from `java.util.TimeZone`, to/from `java.text.Format` is out of scope of this project\n\n#### FAQs\n\n1. What version of Java SE does this project map to?\nThis project currently maps to the contents of release Java 1.8\n\n2. Will the backport be kept up to date?\nThere are no plans for further releases.\nHowever if security issues or bugs are found, or pull requests received then a release may occur.\n\n3. Is this project derived from OpenJDK?\nNo. This project is derived from the Reference Implementation previously hosted on GitHub.\nThat project had a BSD license, which has been preserved here.\nThus, this project is a fork of the fork of the original code before entry to OpenJDK.\n\n### Releases\nAvailable in the [Maven Central repository](https://search.maven.org/search?q=a:org.jresearch.gwt.time)\n\n### Support\nGitHub [issues](https://github.com/foal/gwt-time/issues) and [pull requests](https://github.com/foal/gwt-time/pulls)\nshould be used when you want to help advance the project.\n\nNote that pull requests and issues will only be considered so far as matching the behavior of Java SE releases.\nAdditional requested features will be rejected.\n\nPull requests must _not_ be copied from the JDK, because the GPL license is incompatible with the BSD license used here.\n\n\n### Building from sources\n* check out [APT project](https://github.com/foal/gwt-time-apt) and INSTALL (`mvn clean install`) it.\n* check out this project\n* `mvn clean install`\n* The project use the parent pom located on Sonatype snapshot repository.\n```xml\n\u003crepositories\u003e\n    \u003crepository\u003e\n        \u003cid\u003eoss.sonatype.org-snapshot\u003c/id\u003e\n        \u003curl\u003ehttp://oss.sonatype.org/content/repositories/snapshots\u003c/url\u003e\n        \u003creleases\u003e\u003cenabled\u003efalse\u003c/enabled\u003e\u003c/releases\u003e\n        \u003csnapshots\u003e\u003cenabled\u003etrue\u003c/enabled\u003e\u003c/snapshots\u003e\n    \u003c/repository\u003e\n\u003c/repositories\u003e\n```\nor download directly https://oss.sonatype.org/content/repositories/snapshots/org/jresearch/org.jresearch.pom/29-SNAPSHOT/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoal%2Fgwt-time","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffoal%2Fgwt-time","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffoal%2Fgwt-time/lists"}