44 * |
44 * |
45 * <p>Calendar fields are specified with the constants defined in {@link |
45 * <p>Calendar fields are specified with the constants defined in {@link |
46 * Calendar}. The following are calendar-common fields and their values to be |
46 * Calendar}. The following are calendar-common fields and their values to be |
47 * supported for each calendar system. |
47 * supported for each calendar system. |
48 * |
48 * |
49 * <table class="plain" style="border-bottom:1px solid"> |
49 * <table class="plain"> |
50 * <caption style="display:none">Field values</caption> |
50 * <caption style="display:none">Field values</caption> |
51 * <thead> |
51 * <thead> |
52 * <tr> |
52 * <tr> |
53 * <th>Field</th> |
53 * <th>Field</th> |
54 * <th>Value</th> |
54 * <th>Value</th> |
55 * <th>Description</th> |
55 * <th>Description</th> |
56 * </tr> |
56 * </tr> |
57 * </thead> |
57 * </thead> |
58 * <tbody> |
58 * <tbody> |
59 * <tr> |
59 * <tr> |
60 * <td valign="top">{@link Calendar#MONTH}</td> |
60 * <td style="vertical-align:top">{@link Calendar#MONTH}</td> |
61 * <td valign="top">{@link Calendar#JANUARY} to {@link Calendar#UNDECIMBER}</td> |
61 * <td style="vertical-align:top">{@link Calendar#JANUARY} to {@link Calendar#UNDECIMBER}</td> |
62 * <td>Month numbering is 0-based (e.g., 0 - January, ..., 11 - |
62 * <td>Month numbering is 0-based (e.g., 0 - January, ..., 11 - |
63 * December). Some calendar systems have 13 months. Month |
63 * December). Some calendar systems have 13 months. Month |
64 * names need to be supported in both the formatting and |
64 * names need to be supported in both the formatting and |
65 * stand-alone forms if required by the supported locales. If there's |
65 * stand-alone forms if required by the supported locales. If there's |
66 * no distinction in the two forms, the same names should be returned |
66 * no distinction in the two forms, the same names should be returned |
67 * in both of the forms.</td> |
67 * in both of the forms.</td> |
68 * </tr> |
68 * </tr> |
69 * <tr> |
69 * <tr> |
70 * <td valign="top">{@link Calendar#DAY_OF_WEEK}</td> |
70 * <td style="vertical-align:top">{@link Calendar#DAY_OF_WEEK}</td> |
71 * <td valign="top">{@link Calendar#SUNDAY} to {@link Calendar#SATURDAY}</td> |
71 * <td style="vertical-align:top">{@link Calendar#SUNDAY} to {@link Calendar#SATURDAY}</td> |
72 * <td>Day-of-week numbering is 1-based starting from Sunday (i.e., 1 - Sunday, |
72 * <td>Day-of-week numbering is 1-based starting from Sunday (i.e., 1 - Sunday, |
73 * ..., 7 - Saturday).</td> |
73 * ..., 7 - Saturday).</td> |
74 * </tr> |
74 * </tr> |
75 * <tr> |
75 * <tr> |
76 * <td valign="top">{@link Calendar#AM_PM}</td> |
76 * <td style="vertical-align:top">{@link Calendar#AM_PM}</td> |
77 * <td valign="top">{@link Calendar#AM} to {@link Calendar#PM}</td> |
77 * <td style="vertical-align:top">{@link Calendar#AM} to {@link Calendar#PM}</td> |
78 * <td>0 - AM, 1 - PM</td> |
78 * <td>0 - AM, 1 - PM</td> |
79 * </tr> |
79 * </tr> |
80 * </tbody> |
80 * </tbody> |
81 * </table> |
81 * </table> |
82 * |
82 * |
83 * <p style="margin-top:20px">The following are calendar-specific fields and their values to be supported. |
83 * <p style="margin-top:20px">The following are calendar-specific fields and their values to be supported. |
84 * |
84 * |
85 * <table class="plain" style="border-bottom:1px solid"> |
85 * <table class="plain"> |
86 * <caption style="display:none">Calendar type and field values</caption> |
86 * <caption style="display:none">Calendar type and field values</caption> |
87 * <thead> |
87 * <thead> |
88 * <tr> |
88 * <tr> |
89 * <th>Calendar Type</th> |
89 * <th>Calendar Type</th> |
90 * <th>Field</th> |
90 * <th>Field</th> |
92 * <th>Description</th> |
92 * <th>Description</th> |
93 * </tr> |
93 * </tr> |
94 * </thead> |
94 * </thead> |
95 * <tbody> |
95 * <tbody> |
96 * <tr> |
96 * <tr> |
97 * <td rowspan="2" valign="top">{@code "gregory"}</td> |
97 * <td rowspan="2" style="vertical-align:top">{@code "gregory"}</td> |
98 * <td rowspan="2" valign="top">{@link Calendar#ERA}</td> |
98 * <td rowspan="2" style="vertical-align:top">{@link Calendar#ERA}</td> |
99 * <td>0</td> |
99 * <td>0</td> |
100 * <td>{@link java.util.GregorianCalendar#BC} (BCE)</td> |
100 * <td>{@link java.util.GregorianCalendar#BC} (BCE)</td> |
101 * </tr> |
101 * </tr> |
102 * <tr> |
102 * <tr> |
103 * <td>1</td> |
103 * <td>1</td> |
104 * <td>{@link java.util.GregorianCalendar#AD} (CE)</td> |
104 * <td>{@link java.util.GregorianCalendar#AD} (CE)</td> |
105 * </tr> |
105 * </tr> |
106 * <tr> |
106 * <tr> |
107 * <td rowspan="2" valign="top">{@code "buddhist"}</td> |
107 * <td rowspan="2" style="vertical-align:top">{@code "buddhist"}</td> |
108 * <td rowspan="2" valign="top">{@link Calendar#ERA}</td> |
108 * <td rowspan="2" style="vertical-align:top">{@link Calendar#ERA}</td> |
109 * <td>0</td> |
109 * <td>0</td> |
110 * <td>BC (BCE)</td> |
110 * <td>BC (BCE)</td> |
111 * </tr> |
111 * </tr> |
112 * <tr> |
112 * <tr> |
113 * <td>1</td> |
113 * <td>1</td> |
114 * <td>B.E. (Buddhist Era)</td> |
114 * <td>B.E. (Buddhist Era)</td> |
115 * </tr> |
115 * </tr> |
116 * <tr> |
116 * <tr> |
117 * <td rowspan="6" valign="top">{@code "japanese"}</td> |
117 * <td rowspan="6" style="vertical-align:top">{@code "japanese"}</td> |
118 * <td rowspan="5" valign="top">{@link Calendar#ERA}</td> |
118 * <td rowspan="5" style="vertical-align:top">{@link Calendar#ERA}</td> |
119 * <td>0</td> |
119 * <td>0</td> |
120 * <td>Seireki (Before Meiji)</td> |
120 * <td>Seireki (Before Meiji)</td> |
121 * </tr> |
121 * </tr> |
122 * <tr> |
122 * <tr> |
123 * <td>1</td> |
123 * <td>1</td> |
142 * style ({@link Calendar#LONG_FORMAT} or {@link Calendar#LONG_STANDALONE}) is |
142 * style ({@link Calendar#LONG_FORMAT} or {@link Calendar#LONG_STANDALONE}) is |
143 * specified. See also the <a href="../../text/SimpleDateFormat.html#year"> |
143 * specified. See also the <a href="../../text/SimpleDateFormat.html#year"> |
144 * Year representation in {@code SimpleDateFormat}</a>.</td> |
144 * Year representation in {@code SimpleDateFormat}</a>.</td> |
145 * </tr> |
145 * </tr> |
146 * <tr> |
146 * <tr> |
147 * <td rowspan="2" valign="top">{@code "roc"}</td> |
147 * <td rowspan="2" style="vertical-align:top">{@code "roc"}</td> |
148 * <td rowspan="2" valign="top">{@link Calendar#ERA}</td> |
148 * <td rowspan="2" style="vertical-align:top">{@link Calendar#ERA}</td> |
149 * <td>0</td> |
149 * <td>0</td> |
150 * <td>Before R.O.C.</td> |
150 * <td>Before R.O.C.</td> |
151 * </tr> |
151 * </tr> |
152 * <tr> |
152 * <tr> |
153 * <td>1</td> |
153 * <td>1</td> |
154 * <td>R.O.C.</td> |
154 * <td>R.O.C.</td> |
155 * </tr> |
155 * </tr> |
156 * <tr> |
156 * <tr> |
157 * <td rowspan="2" valign="top">{@code "islamic"}</td> |
157 * <td rowspan="2" style="vertical-align:top">{@code "islamic"}</td> |
158 * <td rowspan="2" valign="top">{@link Calendar#ERA}</td> |
158 * <td rowspan="2" style="vertical-align:top">{@link Calendar#ERA}</td> |
159 * <td>0</td> |
159 * <td>0</td> |
160 * <td>Before AH</td> |
160 * <td>Before AH</td> |
161 * </tr> |
161 * </tr> |
162 * <tr> |
162 * <tr> |
163 * <td>1</td> |
163 * <td>1</td> |