You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ Although the new JSR-310 (built in Java 8) is certainly a very useful library fo
13
13
Current state and introduction:
14
14
-------------------------------
15
15
16
-
On 2020-05-31, the version v5.6 of Time4J has been finished and released. It requires at least Java-8. The older version lines v3.x and v4.x have reached end-of-life with the latest versions v3.50 and v4.38 where v3.x is based on Java 6+7. The previous version lines v1.x and v2.x are no longer recommended (due to several backward incompatibilities) and have reached end-of-life, too. Time4J is organized in modules. The module **time4j-base** is always necessary. Other modules are optional and include:
16
+
On 2020-09-13, the version v5.7 of Time4J has been finished and released. It requires at least Java-8. The older version lines v3.x and v4.x have reached end-of-life with the latest versions v3.50 and v4.38 where v3.x is based on Java 6+7. The previous version lines v1.x and v2.x are no longer recommended (due to several backward incompatibilities) and have reached end-of-life, too. Time4J is organized in modules. The module **time4j-base** is always necessary. Other modules are optional and include:
17
17
18
18
-**time4j-sqlxml** contains a simple adapter for the support of SQL-databases.
19
19
-**time4j-tzdata** encapsulates the time zone repository (independent github-project starting with version 5.0-2018f)
@@ -123,7 +123,7 @@ d) **Temporal arithmetic**: Another way of manipulation is date/time-arithmetic
123
123
124
124
e) **Global versus local**: Time4J rejects the design idea of JSR-310 to separate between "machine time" and "human time". This is considered as artificial. So all four basic types offer both aspects in one. For example a calendar date is simultaneously a human time consisting of several meaningful elements like year, month etc. and also a kind of machine or technical time counter because you can define a single incrementing number represented by julian days. In a similar way a UTC-moment has both a technical counter (the number of SI-seconds since UTC-epoch) AND a human representation visible in its canonical output produced by `toString()`-method (example: 2014-04-21T19:45:30Z). However, Time4J emphasizes the difference between local and global types. Conversion between these types always require a timezone or an offset.
125
125
126
-
f) **Internationalization**: Time4J defines its own i18n-resources for many languages (**95 languages in version 5.6**) in order to defend its i18n-behaviour against poor or insufficient platform resources (which only serve as fallback). Especially localized formatting of durations is not a supported feature on any platform, so Time4J fills an important gap.
126
+
f) **Internationalization**: Time4J defines its own i18n-resources for many languages (**95 languages in version 5.7**) in order to defend its i18n-behaviour against poor or insufficient platform resources (which only serve as fallback). Especially localized formatting of durations is not a supported feature on any platform, so Time4J fills an important gap.
127
127
128
128
g) **Powerful format engine**: The built-in format engine located in format/expert-package offers overwhelmingly many features, general interfaces for customization and outstanding parsing performance (better than in Joda-Time or JSR-310).
129
129
@@ -138,7 +138,7 @@ Support for alternative calendars:
138
138
- French revolutionary
139
139
- Hebrew (including support for Hebrew time)
140
140
- Hijri (Islamic) with a lot of customizable variants
141
-
- Hindu (old solar + old lunar)
141
+
- Hindu (based on algorithms by Dershowitz/Reingold)
142
142
- Historic christian (includes british, byzantine, swedish etc.)
143
143
- Indian national (Saka)
144
144
- Japanese (including lunisolar part since AD 701)
@@ -165,12 +165,12 @@ Add these dependencies to your pom-file (typical setup):
165
165
<dependency>
166
166
<groupId>net.time4j</groupId>
167
167
<artifactId>time4j-base</artifactId>
168
-
<version>5.6</version>
168
+
<version>5.7</version>
169
169
</dependency>
170
170
<dependency>
171
171
<groupId>net.time4j</groupId>
172
172
<artifactId>time4j-sqlxml</artifactId>
173
-
<version>5.6</version>
173
+
<version>5.7</version>
174
174
</dependency>
175
175
<dependency>
176
176
<groupId>net.time4j</groupId>
@@ -185,7 +185,8 @@ Then make sure that the very first usage of Time4J-code starts with the followin
185
185
TZDATA.init();
186
186
```
187
187
188
-
The last step is only necessary for OSGi or module path environments (Java 9+) provided that the timezone repository should be used instead of platform zone rules. This special initialization can be left out if Time4J is run on the traditional classpath (for example Java 8).
188
+
The last step is only necessary for module path environments (Java 9+) provided that the timezone repository should be used instead of platform zone rules. This special initialization can be left out if Time4J is run on the traditional classpath (for example Java 8). Users are also asked to set following system property
189
+
in OSGi-environments: "-Dnet.time4j.base.useClassloaderOnly=true".
189
190
190
191
Please also read the installation notes on Time4J-tutorial.
0 commit comments