mirror of
https://github.com/openjdk/jdk.git
synced 2026-06-12 05:25:07 +00:00
8186153: Fix a11y and HTML issues in the java.math, java.text and java.time packages
Reviewed-by: lancea, bpb
This commit is contained in:
Jonathan Gibbons
parent
c79d52b103
commit
1b9cc2f7a2
@ -120,18 +120,18 @@ import java.util.Arrays;
|
||||
* preferred scale for representing a result. The preferred
|
||||
* scale for each operation is listed in the table below.
|
||||
*
|
||||
* <table class="plain">
|
||||
* <caption><b>Preferred Scales for Results of Arithmetic Operations
|
||||
* </b></caption>
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption>Preferred Scales for Results of Arithmetic Operations
|
||||
* </caption>
|
||||
* <thead>
|
||||
* <tr><th>Operation</th><th>Preferred Scale of Result</th></tr>
|
||||
* <tr><th scope="col">Operation</th><th scope="col">Preferred Scale of Result</th></tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr><td>Add</td><td>max(addend.scale(), augend.scale())</td>
|
||||
* <tr><td>Subtract</td><td>max(minuend.scale(), subtrahend.scale())</td>
|
||||
* <tr><td>Multiply</td><td>multiplier.scale() + multiplicand.scale()</td>
|
||||
* <tr><td>Divide</td><td>dividend.scale() - divisor.scale()</td>
|
||||
* <tr><td>Square root</td><td>radicand.scale()/2</td>
|
||||
* <tr><th scope="row">Add</th><td>max(addend.scale(), augend.scale())</td>
|
||||
* <tr><th scope="row">Subtract</th><td>max(minuend.scale(), subtrahend.scale())</td>
|
||||
* <tr><th scope="row">Multiply</th><td>multiplier.scale() + multiplicand.scale()</td>
|
||||
* <tr><th scope="row">Divide</th><td>dividend.scale() - divisor.scale()</td>
|
||||
* <tr><th scope="row">Square root</th><td>radicand.scale()/2</td>
|
||||
* </tbody>
|
||||
* </table>
|
||||
*
|
||||
|
||||
@ -51,13 +51,13 @@ package java.math;
|
||||
* proper {@code MathContext}. A summary table showing the results
|
||||
* of these rounding operations for all rounding modes appears below.
|
||||
*
|
||||
*<table class="plain">
|
||||
*<table class="striped">
|
||||
* <caption><b>Summary of Rounding Operations Under Different Rounding Modes</b></caption>
|
||||
* <thead>
|
||||
* <tr><th></th><th colspan=8>Result of rounding input to one digit with the given
|
||||
* <tr><th scope="col" rowspan="2">Input Number</th><th scope="col"colspan=8>Result of rounding input to one digit with the given
|
||||
* rounding mode</th>
|
||||
* <tr style="vertical-align:top">
|
||||
* <th>Input Number</th> <th>{@code UP}</th>
|
||||
* <th>{@code UP}</th>
|
||||
* <th>{@code DOWN}</th>
|
||||
* <th>{@code CEILING}</th>
|
||||
* <th>{@code FLOOR}</th>
|
||||
@ -66,18 +66,18 @@ package java.math;
|
||||
* <th>{@code HALF_EVEN}</th>
|
||||
* <th>{@code UNNECESSARY}</th>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tbody style="text-align:right">
|
||||
*
|
||||
* <tr style="text-align:right"><td>5.5</td> <td>6</td> <td>5</td> <td>6</td> <td>5</td> <td>6</td> <td>5</td> <td>6</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>2.5</td> <td>3</td> <td>2</td> <td>3</td> <td>2</td> <td>3</td> <td>2</td> <td>2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>1.6</td> <td>2</td> <td>1</td> <td>2</td> <td>1</td> <td>2</td> <td>2</td> <td>2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>1.1</td> <td>2</td> <td>1</td> <td>2</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>1.0</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td>
|
||||
* <tr style="text-align:right"><td>-1.0</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td>
|
||||
* <tr style="text-align:right"><td>-1.1</td> <td>-2</td> <td>-1</td> <td>-1</td> <td>-2</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>-1.6</td> <td>-2</td> <td>-1</td> <td>-1</td> <td>-2</td> <td>-2</td> <td>-2</td> <td>-2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>-2.5</td> <td>-3</td> <td>-2</td> <td>-2</td> <td>-3</td> <td>-3</td> <td>-2</td> <td>-2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr style="text-align:right"><td>-5.5</td> <td>-6</td> <td>-5</td> <td>-5</td> <td>-6</td> <td>-6</td> <td>-5</td> <td>-6</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">5.5</th> <td>6</td> <td>5</td> <td>6</td> <td>5</td> <td>6</td> <td>5</td> <td>6</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">2.5</th> <td>3</td> <td>2</td> <td>3</td> <td>2</td> <td>3</td> <td>2</td> <td>2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">1.6</th> <td>2</td> <td>1</td> <td>2</td> <td>1</td> <td>2</td> <td>2</td> <td>2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">1.1</th> <td>2</td> <td>1</td> <td>2</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">1.0</th> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td> <td>1</td>
|
||||
* <tr><th scope="row">-1.0</th> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>-1</td>
|
||||
* <tr><th scope="row">-1.1</th> <td>-2</td> <td>-1</td> <td>-1</td> <td>-2</td> <td>-1</td> <td>-1</td> <td>-1</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">-1.6</th> <td>-2</td> <td>-1</td> <td>-1</td> <td>-2</td> <td>-2</td> <td>-2</td> <td>-2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">-2.5</th> <td>-3</td> <td>-2</td> <td>-2</td> <td>-3</td> <td>-3</td> <td>-2</td> <td>-2</td> <td>throw {@code ArithmeticException}</td>
|
||||
* <tr><th scope="row">-5.5</th> <td>-6</td> <td>-5</td> <td>-5</td> <td>-6</td> <td>-6</td> <td>-5</td> <td>-6</td> <td>throw {@code ArithmeticException}</td>
|
||||
* </tbody>
|
||||
* </table>
|
||||
*
|
||||
@ -104,23 +104,23 @@ public enum RoundingMode {
|
||||
* value.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode UP Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode UP Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code UP} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code UP} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>6</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>3</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-3</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-6</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>6</td>
|
||||
*<tr><th scope="row">2.5</th> <td>3</td>
|
||||
*<tr><th scope="row">1.6</th> <td>2</td>
|
||||
*<tr><th scope="row">1.1</th> <td>2</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-2</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-2</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-3</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-6</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -132,23 +132,23 @@ public enum RoundingMode {
|
||||
* rounding mode never increases the magnitude of the calculated value.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode DOWN Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode DOWN Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code DOWN} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code DOWN} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>5</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-5</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>5</td>
|
||||
*<tr><th scope="row">2.5</th> <td>2</td>
|
||||
*<tr><th scope="row">1.6</th> <td>1</td>
|
||||
*<tr><th scope="row">1.1</th> <td>1</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-1</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-2</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-5</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -161,23 +161,23 @@ public enum RoundingMode {
|
||||
* that this rounding mode never decreases the calculated value.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode CEILING Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode CEILING Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code CEILING} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>6</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>3</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-5</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>6</td>
|
||||
*<tr><th scope="row">2.5</th> <td>3</td>
|
||||
*<tr><th scope="row">1.6</th> <td>2</td>
|
||||
*<tr><th scope="row">1.1</th> <td>2</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-1</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-2</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-5</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -190,23 +190,23 @@ public enum RoundingMode {
|
||||
* this rounding mode never increases the calculated value.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode FLOOR Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode FLOOR Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code FLOOR} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code FLOOR} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>5</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-3</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-6</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>5</td>
|
||||
*<tr><th scope="row">2.5</th> <td>2</td>
|
||||
*<tr><th scope="row">1.6</th> <td>1</td>
|
||||
*<tr><th scope="row">1.1</th> <td>1</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-2</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-2</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-3</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-6</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -221,23 +221,23 @@ public enum RoundingMode {
|
||||
* mode commonly taught at school.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode HALF_UP Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode HALF_UP Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code HALF_UP} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code HALF_UP} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>6</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>3</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-3</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-6</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>6</td>
|
||||
*<tr><th scope="row">2.5</th> <td>3</td>
|
||||
*<tr><th scope="row">1.6</th> <td>2</td>
|
||||
*<tr><th scope="row">1.1</th> <td>1</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-2</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-3</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-6</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -251,23 +251,23 @@ public enum RoundingMode {
|
||||
* {@code RoundingMode.DOWN}.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode HALF_DOWN Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode HALF_DOWN Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code HALF_DOWN} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code HALF_DOWN} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>5</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-5</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>5</td>
|
||||
*<tr><th scope="row">2.5</th> <td>2</td>
|
||||
*<tr><th scope="row">1.6</th> <td>2</td>
|
||||
*<tr><th scope="row">1.1</th> <td>1</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-2</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-2</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-5</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -288,23 +288,23 @@ public enum RoundingMode {
|
||||
* arithmetic in Java.
|
||||
*
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode HALF_EVEN Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode HALF_EVEN Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code HALF_EVEN} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code HALF_EVEN} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>6</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>2</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>-2</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>-6</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>6</td>
|
||||
*<tr><th scope="row">2.5</th> <td>2</td>
|
||||
*<tr><th scope="row">1.6</th> <td>2</td>
|
||||
*<tr><th scope="row">1.1</th> <td>1</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>-2</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>-2</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>-6</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
@ -316,23 +316,23 @@ public enum RoundingMode {
|
||||
* specified on an operation that yields an inexact result, an
|
||||
* {@code ArithmeticException} is thrown.
|
||||
*<p>Example:
|
||||
*<table class="plain">
|
||||
* <caption><b>Rounding mode UNNECESSARY Examples</b></caption>
|
||||
*<table class="striped">
|
||||
* <caption>Rounding mode UNNECESSARY Examples</caption>
|
||||
*<thead>
|
||||
*<tr style="vertical-align:top"><th>Input Number</th>
|
||||
* <th>Input rounded to one digit<br> with {@code UNNECESSARY} rounding
|
||||
*<tr style="vertical-align:top"><th scope="col">Input Number</th>
|
||||
* <th scope="col">Input rounded to one digit<br> with {@code UNNECESSARY} rounding
|
||||
*</thead>
|
||||
*<tbody>
|
||||
*<tr style="text-align:right"><td>5.5</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>2.5</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>1.6</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>1.1</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>1.0</td> <td>1</td>
|
||||
*<tr style="text-align:right"><td>-1.0</td> <td>-1</td>
|
||||
*<tr style="text-align:right"><td>-1.1</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>-1.6</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>-2.5</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr style="text-align:right"><td>-5.5</td> <td>throw {@code ArithmeticException}</td>
|
||||
*<tbody style="text-align:right">
|
||||
*<tr><th scope="row">5.5</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">2.5</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">1.6</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">1.1</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">1.0</th> <td>1</td>
|
||||
*<tr><th scope="row">-1.0</th> <td>-1</td>
|
||||
*<tr><th scope="row">-1.1</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">-1.6</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">-2.5</th> <td>throw {@code ArithmeticException}</td>
|
||||
*<tr><th scope="row">-5.5</th> <td>throw {@code ArithmeticException}</td>
|
||||
*</tbody>
|
||||
*</table>
|
||||
*/
|
||||
|
||||
@ -150,73 +150,73 @@ import java.util.Locale;
|
||||
* <caption style="display:none">Shows how FormatType and FormatStyle values map to Format instances</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th id="ft" class="TableHeadingColor">FormatType
|
||||
* <th id="fs" class="TableHeadingColor">FormatStyle
|
||||
* <th id="sc" class="TableHeadingColor">Subformat Created
|
||||
* <th scope="col" class="TableHeadingColor">FormatType
|
||||
* <th scope="col" class="TableHeadingColor">FormatStyle
|
||||
* <th scope="col" class="TableHeadingColor">Subformat Created
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td headers="ft"><i>(none)</i>
|
||||
* <td headers="fs"><i>(none)</i>
|
||||
* <td headers="sc"><code>null</code>
|
||||
* <th scope="row" style="text-weight: normal"><i>(none)</i>
|
||||
* <th scope="row" style="text-weight: normal"><i>(none)</i>
|
||||
* <td>{@code null}
|
||||
* <tr>
|
||||
* <td headers="ft" rowspan=5><code>number</code>
|
||||
* <td headers="fs"><i>(none)</i>
|
||||
* <td headers="sc">{@link NumberFormat#getInstance(Locale) NumberFormat.getInstance}{@code (getLocale())}
|
||||
* <th scope="row" style="text-weight: normal" rowspan=5>{@code number}
|
||||
* <th scope="row" style="text-weight: normal"><i>(none)</i>
|
||||
* <td>{@link NumberFormat#getInstance(Locale) NumberFormat.getInstance}{@code (getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>integer</code>
|
||||
* <td headers="sc">{@link NumberFormat#getIntegerInstance(Locale) NumberFormat.getIntegerInstance}{@code (getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code integer}
|
||||
* <td>{@link NumberFormat#getIntegerInstance(Locale) NumberFormat.getIntegerInstance}{@code (getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>currency</code>
|
||||
* <td headers="sc">{@link NumberFormat#getCurrencyInstance(Locale) NumberFormat.getCurrencyInstance}{@code (getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code currency}
|
||||
* <td>{@link NumberFormat#getCurrencyInstance(Locale) NumberFormat.getCurrencyInstance}{@code (getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>percent</code>
|
||||
* <td headers="sc">{@link NumberFormat#getPercentInstance(Locale) NumberFormat.getPercentInstance}{@code (getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code percent}
|
||||
* <td>{@link NumberFormat#getPercentInstance(Locale) NumberFormat.getPercentInstance}{@code (getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><i>SubformatPattern</i>
|
||||
* <td headers="sc">{@code new} {@link DecimalFormat#DecimalFormat(String,DecimalFormatSymbols) DecimalFormat}{@code (subformatPattern,} {@link DecimalFormatSymbols#getInstance(Locale) DecimalFormatSymbols.getInstance}{@code (getLocale()))}
|
||||
* <th scope="row" style="text-weight: normal"><i>SubformatPattern</i>
|
||||
* <td>{@code new} {@link DecimalFormat#DecimalFormat(String,DecimalFormatSymbols) DecimalFormat}{@code (subformatPattern,} {@link DecimalFormatSymbols#getInstance(Locale) DecimalFormatSymbols.getInstance}{@code (getLocale()))}
|
||||
* <tr>
|
||||
* <td headers="ft" rowspan=6><code>date</code>
|
||||
* <td headers="fs"><i>(none)</i>
|
||||
* <td headers="sc">{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal" rowspan=6>{@code date}
|
||||
* <th scope="row" style="text-weight: normal"><i>(none)</i>
|
||||
* <td>{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>short</code>
|
||||
* <td headers="sc">{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#SHORT}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code short}
|
||||
* <td>{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#SHORT}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>medium</code>
|
||||
* <td headers="sc">{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code medium}
|
||||
* <td>{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>long</code>
|
||||
* <td headers="sc">{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#LONG}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code long}
|
||||
* <td>{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#LONG}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>full</code>
|
||||
* <td headers="sc">{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#FULL}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code full}
|
||||
* <td>{@link DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance}{@code (}{@link DateFormat#FULL}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><i>SubformatPattern</i>
|
||||
* <td headers="sc">{@code new} {@link SimpleDateFormat#SimpleDateFormat(String,Locale) SimpleDateFormat}{@code (subformatPattern, getLocale())}
|
||||
* <th scope="row" style="text-weight: normal"><i>SubformatPattern</i>
|
||||
* <td>{@code new} {@link SimpleDateFormat#SimpleDateFormat(String,Locale) SimpleDateFormat}{@code (subformatPattern, getLocale())}
|
||||
* <tr>
|
||||
* <td headers="ft" rowspan=6><code>time</code>
|
||||
* <td headers="fs"><i>(none)</i>
|
||||
* <td headers="sc">{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal" rowspan=6>{@code time}
|
||||
* <th scope="row" style="text-weight: normal"><i>(none)</i>
|
||||
* <td>{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>short</code>
|
||||
* <td headers="sc">{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#SHORT}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code short}
|
||||
* <td>{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#SHORT}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>medium</code>
|
||||
* <td headers="sc">{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code medium}
|
||||
* <td>{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#DEFAULT}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>long</code>
|
||||
* <td headers="sc">{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#LONG}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code long}
|
||||
* <td>{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#LONG}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><code>full</code>
|
||||
* <td headers="sc">{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#FULL}{@code , getLocale())}
|
||||
* <th scope="row" style="text-weight: normal">{@code full}
|
||||
* <td>{@link DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance}{@code (}{@link DateFormat#FULL}{@code , getLocale())}
|
||||
* <tr>
|
||||
* <td headers="fs"><i>SubformatPattern</i>
|
||||
* <td headers="sc">{@code new} {@link SimpleDateFormat#SimpleDateFormat(String,Locale) SimpleDateFormat}{@code (subformatPattern, getLocale())}
|
||||
* <th scope="row" style="text-weight: normal"><i>SubformatPattern</i>
|
||||
* <td>{@code new} {@link SimpleDateFormat#SimpleDateFormat(String,Locale) SimpleDateFormat}{@code (subformatPattern, getLocale())}
|
||||
* <tr>
|
||||
* <td headers="ft"><code>choice</code>
|
||||
* <td headers="fs"><i>SubformatPattern</i>
|
||||
* <td headers="sc">{@code new} {@link ChoiceFormat#ChoiceFormat(String) ChoiceFormat}{@code (subformatPattern)}
|
||||
* <th scope="row" style="text-weight: normal">{@code choice}
|
||||
* <th scope="row" style="text-weight: normal"><i>SubformatPattern</i>
|
||||
* <td>{@code new} {@link ChoiceFormat#ChoiceFormat(String) ChoiceFormat}{@code (subformatPattern)}
|
||||
* </tbody>
|
||||
* </table>
|
||||
*
|
||||
@ -776,44 +776,40 @@ public class MessageFormat extends Format {
|
||||
* <caption style="display:none">Examples of subformat,argument,and formatted text</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th>Subformat
|
||||
* <th>Argument
|
||||
* <th>Formatted Text
|
||||
* <th scope="col">Subformat
|
||||
* <th scope="col">Argument
|
||||
* <th scope="col">Formatted Text
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td><i>any</i>
|
||||
* <td><i>unavailable</i>
|
||||
* <th scope="row" style="text-weight-normal" rowspan=2><i>any</i>
|
||||
* <th scope="row" style="text-weight-normal"><i>unavailable</i>
|
||||
* <td><code>"{" + argumentIndex + "}"</code>
|
||||
* <tr>
|
||||
* <td><i>any</i>
|
||||
* <td><code>null</code>
|
||||
* <th scope="row" style="text-weight-normal"><code>null</code>
|
||||
* <td><code>"null"</code>
|
||||
* <tr>
|
||||
* <td><code>instanceof ChoiceFormat</code>
|
||||
* <td><i>any</i>
|
||||
* <th scope="row" style="text-weight-normal"><code>instanceof ChoiceFormat</code>
|
||||
* <th scope="row" style="text-weight-normal"><i>any</i>
|
||||
* <td><code>subformat.format(argument).indexOf('{') >= 0 ?<br>
|
||||
* (new MessageFormat(subformat.format(argument), getLocale())).format(argument) :
|
||||
* subformat.format(argument)</code>
|
||||
* <tr>
|
||||
* <td><code>!= null</code>
|
||||
* <td><i>any</i>
|
||||
* <th scope="row" style="text-weight-normal"><code>!= null</code>
|
||||
* <th scope="row" style="text-weight-normal"><i>any</i>
|
||||
* <td><code>subformat.format(argument)</code>
|
||||
* <tr>
|
||||
* <td><code>null</code>
|
||||
* <td><code>instanceof Number</code>
|
||||
* <th scope="row" style="text-weight-normal" rowspan=4><code>null</code>
|
||||
* <th scope="row" style="text-weight-normal"><code>instanceof Number</code>
|
||||
* <td><code>NumberFormat.getInstance(getLocale()).format(argument)</code>
|
||||
* <tr>
|
||||
* <td><code>null</code>
|
||||
* <td><code>instanceof Date</code>
|
||||
* <th scope="row" style="text-weight-normal"><code>instanceof Date</code>
|
||||
* <td><code>DateFormat.getDateTimeInstance(DateFormat.SHORT, DateFormat.SHORT, getLocale()).format(argument)</code>
|
||||
* <tr>
|
||||
* <td><code>null</code>
|
||||
* <td><code>instanceof String</code>
|
||||
* <th scope="row" style="text-weight-normal"><code>instanceof String</code>
|
||||
* <td><code>argument</code>
|
||||
* <tr>
|
||||
* <td><code>null</code>
|
||||
* <td><i>any</i>
|
||||
* <th scope="row" style="text-weight-normal"><i>any</i>
|
||||
* <td><code>argument.toString()</code>
|
||||
* </tbody>
|
||||
* </table>
|
||||
|
||||
@ -103,19 +103,19 @@ import sun.util.logging.PlatformLogger;
|
||||
*
|
||||
* <p>
|
||||
* CLDR and LDML identify variants:
|
||||
* <table class="striped">
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption style="display:none">Variants of Hijrah Calendars</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th style="text-align:left" >Chronology ID</th>
|
||||
* <th style="text-align:left" >Calendar Type</th>
|
||||
* <th style="text-align:left" >Locale extension, see {@link java.util.Locale}</th>
|
||||
* <th style="text-align:left" >Description</th>
|
||||
* <th scope="col">Chronology ID</th>
|
||||
* <th scope="col">Calendar Type</th>
|
||||
* <th scope="col">Locale extension, see {@link java.util.Locale}</th>
|
||||
* <th scope="col">Description</th>
|
||||
* </tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td>Hijrah-umalqura</td>
|
||||
* <th scope="row">Hijrah-umalqura</th>
|
||||
* <td>islamic-umalqura</td>
|
||||
* <td>ca-islamic-umalqura</td>
|
||||
* <td>Islamic - Umm Al-Qura calendar of Saudi Arabia</td>
|
||||
@ -148,38 +148,38 @@ import sun.util.logging.PlatformLogger;
|
||||
* <p>
|
||||
* The Hijrah property resource is a set of properties that describe the calendar.
|
||||
* The syntax is defined by {@code java.util.Properties#load(Reader)}.
|
||||
* <table class="striped">
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption style="display:none">Configuration of Hijrah Calendar</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th style="text-align:left" > Property Name</th>
|
||||
* <th style="text-align:left" > Property value</th>
|
||||
* <th style="text-align:left" > Description </th>
|
||||
* <th scope="col">Property Name</th>
|
||||
* <th scope="col">Property value</th>
|
||||
* <th scope="col">Description</th>
|
||||
* </tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td>id</td>
|
||||
* <th scope="row">id</th>
|
||||
* <td>Chronology Id, for example, "Hijrah-umalqura"</td>
|
||||
* <td>The Id of the calendar in common usage</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>type</td>
|
||||
* <th scope="row">type</th>
|
||||
* <td>Calendar type, for example, "islamic-umalqura"</td>
|
||||
* <td>LDML defines the calendar types</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>version</td>
|
||||
* <th scope="row">version</th>
|
||||
* <td>Version, for example: "1.8.0_1"</td>
|
||||
* <td>The version of the Hijrah variant data</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>iso-start</td>
|
||||
* <th scope="row">iso-start</th>
|
||||
* <td>ISO start date, formatted as {@code yyyy-MM-dd}, for example: "1900-04-30"</td>
|
||||
* <td>The ISO date of the first day of the minimum Hijrah year.</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>yyyy - a numeric 4 digit year, for example "1434"</td>
|
||||
* <th scope="row">yyyy - a numeric 4 digit year, for example "1434"</th>
|
||||
* <td>The value is a sequence of 12 month lengths,
|
||||
* for example: "29 30 29 30 29 30 30 30 29 30 29 29"</td>
|
||||
* <td>The lengths of the 12 months of the year separated by whitespace.
|
||||
|
||||
@ -70,27 +70,27 @@ import java.time.DateTimeException;
|
||||
* A definition has therefore been created with two eras - 'Current era' (CE) for
|
||||
* years on or after 0001-01-01 (ISO), and 'Before current era' (BCE) for years before that.
|
||||
*
|
||||
* <table class="striped">
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption style="display:none">ISO years and eras</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th style="text-align:left">year-of-era</th>
|
||||
* <th style="text-align:left">era</th>
|
||||
* <th style="text-align:left">proleptic-year</th>
|
||||
* <th scope="col">year-of-era</th>
|
||||
* <th scope="col">era</th>
|
||||
* <th scope="col">proleptic-year</th>
|
||||
* </tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td>2</td><td>CE</td><td>2</td>
|
||||
* <td>2</td><td>CE</td><th scope="row">2</th>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>1</td><td>CE</td><td>1</td>
|
||||
* <td>1</td><td>CE</td><th scope="row">1</th>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>1</td><td>BCE</td><td>0</td>
|
||||
* <td>1</td><td>BCE</td><th scope="row">0</th>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>2</td><td>BCE</td><td>-1</td>
|
||||
* <td>2</td><td>BCE</td><th scope="row">-1</th>
|
||||
* </tr>
|
||||
* </tbody>
|
||||
* </table>
|
||||
|
||||
@ -71,28 +71,28 @@ import java.time.DateTimeException;
|
||||
* All previous years, zero or earlier in the proleptic count or one and greater
|
||||
* in the year-of-era count, are part of the 'Before Republic of China' era.
|
||||
*
|
||||
* <table class="striped">
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption style="display:none">Minguo years and eras</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th style="text-align:left">year-of-era</th>
|
||||
* <th style="text-align:left">era</th>
|
||||
* <th style="text-align:left">proleptic-year</th>
|
||||
* <th style="text-align:left">ISO proleptic-year</th>
|
||||
* <th>year-of-era</th>
|
||||
* <th>era</th>
|
||||
* <th>proleptic-year</th>
|
||||
* <th>ISO proleptic-year</th>
|
||||
* </tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td>2</td><td>ROC</td><td>2</td><td>1913</td>
|
||||
* <td>2</td><td>ROC</td><th scope="row">2</th><td>1913</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>1</td><td>ROC</td><td>1</td><td>1912</td>
|
||||
* <td>1</td><td>ROC</td><th scope="row">1</th><td>1912</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>1</td><td>BEFORE_ROC</td><td>0</td><td>1911</td>
|
||||
* <td>1</td><td>BEFORE_ROC</td><th scope="row">0</th><td>1911</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>2</td><td>BEFORE_ROC</td><td>-1</td><td>1910</td>
|
||||
* <td>2</td><td>BEFORE_ROC</td><th scope="row">-1</th><td>1910</td>
|
||||
* </tr>
|
||||
* </tbody>
|
||||
* </table>
|
||||
|
||||
@ -71,28 +71,28 @@ import java.time.DateTimeException;
|
||||
* All previous years, zero or earlier in the proleptic count or one and greater
|
||||
* in the year-of-era count, are part of the 'Before Buddhist' era.
|
||||
*
|
||||
* <table class="striped">
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption style="display:none">Buddhist years and eras</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th style="text-align:left">year-of-era</th>
|
||||
* <th style="text-align:left">era</th>
|
||||
* <th style="text-align:left">proleptic-year</th>
|
||||
* <th style="text-align:left">ISO proleptic-year</th>
|
||||
* <th scope="col">year-of-era</th>
|
||||
* <th scope="col">era</th>
|
||||
* <th scope="col">proleptic-year</th>
|
||||
* <th scope="col">ISO proleptic-year</th>
|
||||
* </tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr>
|
||||
* <td>2</td><td>BE</td><td>2</td><td>-542</td>
|
||||
* <td>2</td><td>BE</td><th scope="row">2</th><td>-542</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>1</td><td>BE</td><td>1</td><td>-543</td>
|
||||
* <td>1</td><td>BE</td><th scope="row">1</th><td>-543</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>1</td><td>BEFORE_BE</td><td>0</td><td>-544</td>
|
||||
* <td>1</td><td>BEFORE_BE</td><th scope="row">0</th><td>-544</td>
|
||||
* </tr>
|
||||
* <tr>
|
||||
* <td>2</td><td>BEFORE_BE</td><td>-1</td><td>-545</td>
|
||||
* <td>2</td><td>BEFORE_BE</td><th scope="row">-1</th><td>-545</td>
|
||||
* </tr>
|
||||
* </tbody>
|
||||
* </table>
|
||||
|
||||
@ -150,13 +150,13 @@ import java.util.Set;
|
||||
* implementation of {@code java.text.Format}.
|
||||
*
|
||||
* <h3 id="predefined">Predefined Formatters</h3>
|
||||
* <table class="striped">
|
||||
* <table class="striped" style="text-align:left">
|
||||
* <caption>Predefined Formatters</caption>
|
||||
* <thead>
|
||||
* <tr>
|
||||
* <th scope="col" style="text-align:left">Formatter</th>
|
||||
* <th scope="col" style="text-align:left">Description</th>
|
||||
* <th scope="col" style="text-align:left">Example</th>
|
||||
* <th scope="col">Formatter</th>
|
||||
* <th scope="col">Description</th>
|
||||
* <th scope="col">Example</th>
|
||||
* </tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
@ -276,56 +276,60 @@ import java.util.Set;
|
||||
* <p>
|
||||
* All letters 'A' to 'Z' and 'a' to 'z' are reserved as pattern letters. The
|
||||
* following pattern letters are defined:
|
||||
* <pre>
|
||||
* Symbol Meaning Presentation Examples
|
||||
* ------ ------- ------------ -------
|
||||
* G era text AD; Anno Domini; A
|
||||
* u year year 2004; 04
|
||||
* y year-of-era year 2004; 04
|
||||
* D day-of-year number 189
|
||||
* M/L month-of-year number/text 7; 07; Jul; July; J
|
||||
* d day-of-month number 10
|
||||
* g modified-julian-day number 2451334
|
||||
* <table class="striped">
|
||||
* <caption>Pattern Letters and Symbols</caption>
|
||||
* <thead>
|
||||
* <tr><th scope="col">Symbol</th> <th scope="col">Meaning</th> <th scope="col">Presentation</th> <th scope="col">Examples</th>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr><th scope="row">G</th> <td>era</td> <td>text</td> <td>AD; Anno Domini; A</td>
|
||||
* <tr><th scope="row">u</th> <td>year</td> <td>year</td> <td>2004; 04</td>
|
||||
* <tr><th scope="row">y</th> <td>year-of-era</td> <td>year</td> <td>2004; 04</td>
|
||||
* <tr><th scope="row">D</th> <td>day-of-year</td> <td>number</td> <td>189</td>
|
||||
* <tr><th scope="row">M/L</th> <td>month-of-year</td> <td>number/text</td> <td>7; 07; Jul; July; J</td>
|
||||
* <tr><th scope="row">d</th> <td>day-of-month</td> <td>number</td> <td>10</td>
|
||||
* <tr><th scope="row">g</th> <td>modified-julian-day</td> <td>number</td> <td>2451334</td>
|
||||
*
|
||||
* Q/q quarter-of-year number/text 3; 03; Q3; 3rd quarter
|
||||
* Y week-based-year year 1996; 96
|
||||
* w week-of-week-based-year number 27
|
||||
* W week-of-month number 4
|
||||
* E day-of-week text Tue; Tuesday; T
|
||||
* e/c localized day-of-week number/text 2; 02; Tue; Tuesday; T
|
||||
* F day-of-week-in-month number 3
|
||||
* <tr><th scope="row">Q/q</th> <td>quarter-of-year</td> <td>number/text</td> <td>3; 03; Q3; 3rd quarter</td>
|
||||
* <tr><th scope="row">Y</th> <td>week-based-year</td> <td>year</td> <td>1996; 96</td>
|
||||
* <tr><th scope="row">w</th> <td>week-of-week-based-year</td> <td>number</td> <td>27</td>
|
||||
* <tr><th scope="row">W</th> <td>week-of-month</td> <td>number</td> <td>4</td>
|
||||
* <tr><th scope="row">E</th> <td>day-of-week</td> <td>text</td> <td>Tue; Tuesday; T</td>
|
||||
* <tr><th scope="row">e/c</th> <td>localized day-of-week</td> <td>number/text</td> <td>2; 02; Tue; Tuesday; T</td>
|
||||
* <tr><th scope="row">F</th> <td>day-of-week-in-month</td> <td>number</td> <td>3</td>
|
||||
*
|
||||
* a am-pm-of-day text PM
|
||||
* h clock-hour-of-am-pm (1-12) number 12
|
||||
* K hour-of-am-pm (0-11) number 0
|
||||
* k clock-hour-of-day (1-24) number 24
|
||||
* <tr><th scope="row">a</th> <td>am-pm-of-day</td> <td>text</td> <td>PM</td>
|
||||
* <tr><th scope="row">h</th> <td>clock-hour-of-am-pm (1-12)</td> <td>number</td> <td>12</td>
|
||||
* <tr><th scope="row">K</th> <td>hour-of-am-pm (0-11)</td> <td>number</td> <td>0</td>
|
||||
* <tr><th scope="row">k</th> <td>clock-hour-of-day (1-24)</td> <td>number</td> <td>24</td>
|
||||
*
|
||||
* H hour-of-day (0-23) number 0
|
||||
* m minute-of-hour number 30
|
||||
* s second-of-minute number 55
|
||||
* S fraction-of-second fraction 978
|
||||
* A milli-of-day number 1234
|
||||
* n nano-of-second number 987654321
|
||||
* N nano-of-day number 1234000000
|
||||
* <tr><th scope="row">H</th> <td>hour-of-day (0-23)</td> <td>number</td> <td>0</td>
|
||||
* <tr><th scope="row">m</th> <td>minute-of-hour</td> <td>number</td> <td>30</td>
|
||||
* <tr><th scope="row">s</th> <td>second-of-minute</td> <td>number</td> <td>55</td>
|
||||
* <tr><th scope="row">S</th> <td>fraction-of-second</td> <td>fraction</td> <td>978</td>
|
||||
* <tr><th scope="row">A</th> <td>milli-of-day</td> <td>number</td> <td>1234</td>
|
||||
* <tr><th scope="row">n</th> <td>nano-of-second</td> <td>number</td> <td>987654321</td>
|
||||
* <tr><th scope="row">N</th> <td>nano-of-day</td> <td>number</td> <td>1234000000</td>
|
||||
*
|
||||
* V time-zone ID zone-id America/Los_Angeles; Z; -08:30
|
||||
* v generic time-zone name zone-name Pacific Time; PT
|
||||
* z time-zone name zone-name Pacific Standard Time; PST
|
||||
* O localized zone-offset offset-O GMT+8; GMT+08:00; UTC-08:00
|
||||
* X zone-offset 'Z' for zero offset-X Z; -08; -0830; -08:30; -083015; -08:30:15
|
||||
* x zone-offset offset-x +0000; -08; -0830; -08:30; -083015; -08:30:15
|
||||
* Z zone-offset offset-Z +0000; -0800; -08:00
|
||||
* <tr><th scope="row">V</th> <td>time-zone ID</td> <td>zone-id</td> <td>America/Los_Angeles; Z; -08:30</td>
|
||||
* <tr><th scope="row">v</th> <td>generic time-zone name</td> <td>zone-name</td> <td>Pacific Time; PT</td>
|
||||
* <tr><th scope="row">z</th> <td>time-zone name</td> <td>zone-name</td> <td>Pacific Standard Time; PST</td>
|
||||
* <tr><th scope="row">O</th> <td>localized zone-offset</td> <td>offset-O</td> <td>GMT+8; GMT+08:00; UTC-08:00</td>
|
||||
* <tr><th scope="row">X</th> <td>zone-offset 'Z' for zero</td> <td>offset-X</td> <td>Z; -08; -0830; -08:30; -083015; -08:30:15</td>
|
||||
* <tr><th scope="row">x</th> <td>zone-offset</td> <td>offset-x</td> <td>+0000; -08; -0830; -08:30; -083015; -08:30:15</td>
|
||||
* <tr><th scope="row">Z</th> <td>zone-offset</td> <td>offset-Z</td> <td>+0000; -0800; -08:00</td>
|
||||
*
|
||||
* p pad next pad modifier 1
|
||||
* <tr><th scope="row">p</th> <td>pad next</td> <td>pad modifier</td> <td>1</td>
|
||||
*
|
||||
* ' escape for text delimiter
|
||||
* '' single quote literal '
|
||||
* [ optional section start
|
||||
* ] optional section end
|
||||
* # reserved for future use
|
||||
* { reserved for future use
|
||||
* } reserved for future use
|
||||
* </pre>
|
||||
* <tr><th scope="row">'</th> <td>escape for text</td> <td>delimiter</td> <td></td>
|
||||
* <tr><th scope="row">''</th> <td>single quote</td> <td>literal</td> <td>'</td>
|
||||
* <tr><th scope="row">[</th> <td>optional section start</td> <td></td> <td></td>
|
||||
* <tr><th scope="row">]</th> <td>optional section end</td> <td></td> <td></td>
|
||||
* <tr><th scope="row">#</th> <td>reserved for future use</td> <td></td> <td></td>
|
||||
* <tr><th scope="row">{</th> <td>reserved for future use</td> <td></td> <td></td>
|
||||
* <tr><th scope="row">}</th> <td>reserved for future use</td> <td></td> <td></td>
|
||||
* </tbody>
|
||||
* </table>
|
||||
* <p>
|
||||
* The count of pattern letters determines the format.
|
||||
* <p>
|
||||
|
||||
@ -136,18 +136,18 @@ import sun.util.locale.provider.LocaleResources;
|
||||
* <p>
|
||||
* For example:
|
||||
*
|
||||
* <table class=striped style="text-align: left; width: 50%;">
|
||||
* <table class=striped style="text-align: left">
|
||||
* <caption>Examples of Week based Years</caption>
|
||||
* <thead>
|
||||
* <tr><th>Date</th><th>Day-of-week</th><th>Field values</th></tr>
|
||||
* <tr><th scope="col">Date</th><th scope="col">Day-of-week</th><th scope="col">Field values</th></tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr><th>2008-12-28</th><td>Sunday</td><td>Week 52 of week-based-year 2008</td></tr>
|
||||
* <tr><th>2008-12-29</th><td>Monday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th>2008-12-31</th><td>Wednesday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th>2009-01-01</th><td>Thursday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th>2009-01-04</th><td>Sunday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th>2009-01-05</th><td>Monday</td><td>Week 2 of week-based-year 2009</td></tr>
|
||||
* <tr><th scope="row">2008-12-28</th><td>Sunday</td><td>Week 52 of week-based-year 2008</td></tr>
|
||||
* <tr><th scope="row">2008-12-29</th><td>Monday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th scope="row">2008-12-31</th><td>Wednesday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th scope="row">2009-01-01</th><td>Thursday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th scope="row">2009-01-04</th><td>Sunday</td><td>Week 1 of week-based-year 2009</td></tr>
|
||||
* <tr><th scope="row">2009-01-05</th><td>Monday</td><td>Week 2 of week-based-year 2009</td></tr>
|
||||
* </tbody>
|
||||
* </table>
|
||||
*
|
||||
|
||||
@ -130,17 +130,17 @@ import sun.util.locale.provider.LocaleResources;
|
||||
* <table class=striped style="text-align: left">
|
||||
* <caption>Examples of WeekFields</caption>
|
||||
* <thead>
|
||||
* <tr><th>Date</th><td>Day-of-week</td>
|
||||
* <td>First day: Monday<br>Minimal days: 4</td><td>First day: Monday<br>Minimal days: 5</td></tr>
|
||||
* <tr><th scope="col">Date</th><th scope="col">Day-of-week</th>
|
||||
* <th scope="col">First day: Monday<br>Minimal days: 4</th><th scope="col">First day: Monday<br>Minimal days: 5</th></tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr><th>2008-12-31</th><td>Wednesday</td>
|
||||
* <tr><th scope="row">2008-12-31</th><td>Wednesday</td>
|
||||
* <td>Week 5 of December 2008</td><td>Week 5 of December 2008</td></tr>
|
||||
* <tr><th>2009-01-01</th><td>Thursday</td>
|
||||
* <tr><th scope="row">2009-01-01</th><td>Thursday</td>
|
||||
* <td>Week 1 of January 2009</td><td>Week 0 of January 2009</td></tr>
|
||||
* <tr><th>2009-01-04</th><td>Sunday</td>
|
||||
* <tr><th scope="row">2009-01-04</th><td>Sunday</td>
|
||||
* <td>Week 1 of January 2009</td><td>Week 0 of January 2009</td></tr>
|
||||
* <tr><th>2009-01-05</th><td>Monday</td>
|
||||
* <tr><th scope="row">2009-01-05</th><td>Monday</td>
|
||||
* <td>Week 2 of January 2009</td><td>Week 1 of January 2009</td></tr>
|
||||
* </tbody>
|
||||
* </table>
|
||||
@ -164,17 +164,17 @@ import sun.util.locale.provider.LocaleResources;
|
||||
* <table class=striped style="text-align: left;">
|
||||
* <caption>Examples of WeekFields for week-based-year</caption>
|
||||
* <thead>
|
||||
* <tr><th>Date</th><td>Day-of-week</td>
|
||||
* <td>First day: Monday<br>Minimal days: 4</td><td>First day: Monday<br>Minimal days: 5</td></tr>
|
||||
* <tr><th scope="col">Date</th><th scope="col">Day-of-week</th>
|
||||
* <th scope="col">First day: Monday<br>Minimal days: 4</th><th scope="col">First day: Monday<br>Minimal days: 5</th></tr>
|
||||
* </thead>
|
||||
* <tbody>
|
||||
* <tr><th>2008-12-31</th><td>Wednesday</td>
|
||||
* <tr><th scope="row">2008-12-31</th><td>Wednesday</td>
|
||||
* <td>Week 1 of 2009</td><td>Week 53 of 2008</td></tr>
|
||||
* <tr><th>2009-01-01</th><td>Thursday</td>
|
||||
* <tr><th scope="row">2009-01-01</th><td>Thursday</td>
|
||||
* <td>Week 1 of 2009</td><td>Week 53 of 2008</td></tr>
|
||||
* <tr><th>2009-01-04</th><td>Sunday</td>
|
||||
* <tr><th scope="row">2009-01-04</th><td>Sunday</td>
|
||||
* <td>Week 1 of 2009</td><td>Week 53 of 2008</td></tr>
|
||||
* <tr><th>2009-01-05</th><td>Monday</td>
|
||||
* <tr><th scope="row">2009-01-05</th><td>Monday</td>
|
||||
* <td>Week 2 of 2009</td><td>Week 1 of 2009</td></tr>
|
||||
* </tbody>
|
||||
* </table>
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user