jdk/src/java.base/share/classes/java/text/SimpleDateFormat.java
changeset 45881 aaec0fbe17ae
parent 45434 4582657c7260
equal deleted inserted replaced
45871:878e21603932 45881:aaec0fbe17ae
    94  * <blockquote>
    94  * <blockquote>
    95  * <table class="striped">
    95  * <table class="striped">
    96  * <caption style="display:none">Chart shows pattern letters, date/time component, presentation, and examples.</caption>
    96  * <caption style="display:none">Chart shows pattern letters, date/time component, presentation, and examples.</caption>
    97  * <thead>
    97  * <thead>
    98  *     <tr>
    98  *     <tr>
    99  *         <th style="text-align:left">Letter
    99  *         <th scope="col" style="text-align:left">Letter
   100  *         <th style="text-align:left">Date or Time Component
   100  *         <th scope="col" style="text-align:left">Date or Time Component
   101  *         <th style="text-align:left">Presentation
   101  *         <th scope="col" style="text-align:left">Presentation
   102  *         <th style="text-align:left">Examples
   102  *         <th scope="col" style="text-align:left">Examples
   103  * </thead>
   103  * </thead>
   104  * <tbody>
   104  * <tbody>
   105  *     <tr>
   105  *     <tr>
   106  *         <td><code>G</code>
   106  *         <th scope="row"><code>G</code>
   107  *         <td>Era designator
   107  *         <td>Era designator
   108  *         <td><a href="#text">Text</a>
   108  *         <td><a href="#text">Text</a>
   109  *         <td><code>AD</code>
   109  *         <td><code>AD</code>
   110  *     <tr>
   110  *     <tr>
   111  *         <td><code>y</code>
   111  *         <th scope="row"><code>y</code>
   112  *         <td>Year
   112  *         <td>Year
   113  *         <td><a href="#year">Year</a>
   113  *         <td><a href="#year">Year</a>
   114  *         <td><code>1996</code>; <code>96</code>
   114  *         <td><code>1996</code>; <code>96</code>
   115  *     <tr>
   115  *     <tr>
   116  *         <td><code>Y</code>
   116  *         <th scope="row"><code>Y</code>
   117  *         <td>Week year
   117  *         <td>Week year
   118  *         <td><a href="#year">Year</a>
   118  *         <td><a href="#year">Year</a>
   119  *         <td><code>2009</code>; <code>09</code>
   119  *         <td><code>2009</code>; <code>09</code>
   120  *     <tr>
   120  *     <tr>
   121  *         <td><code>M</code>
   121  *         <th scope="row"><code>M</code>
   122  *         <td>Month in year (context sensitive)
   122  *         <td>Month in year (context sensitive)
   123  *         <td><a href="#month">Month</a>
   123  *         <td><a href="#month">Month</a>
   124  *         <td><code>July</code>; <code>Jul</code>; <code>07</code>
   124  *         <td><code>July</code>; <code>Jul</code>; <code>07</code>
   125  *     <tr>
   125  *     <tr>
   126  *         <td><code>L</code>
   126  *         <th scope="row"><code>L</code>
   127  *         <td>Month in year (standalone form)
   127  *         <td>Month in year (standalone form)
   128  *         <td><a href="#month">Month</a>
   128  *         <td><a href="#month">Month</a>
   129  *         <td><code>July</code>; <code>Jul</code>; <code>07</code>
   129  *         <td><code>July</code>; <code>Jul</code>; <code>07</code>
   130  *     <tr>
   130  *     <tr>
   131  *         <td><code>w</code>
   131  *         <th scope="row"><code>w</code>
   132  *         <td>Week in year
   132  *         <td>Week in year
   133  *         <td><a href="#number">Number</a>
   133  *         <td><a href="#number">Number</a>
   134  *         <td><code>27</code>
   134  *         <td><code>27</code>
   135  *     <tr>
   135  *     <tr>
   136  *         <td><code>W</code>
   136  *         <th scope="row"><code>W</code>
   137  *         <td>Week in month
   137  *         <td>Week in month
   138  *         <td><a href="#number">Number</a>
   138  *         <td><a href="#number">Number</a>
   139  *         <td><code>2</code>
   139  *         <td><code>2</code>
   140  *     <tr>
   140  *     <tr>
   141  *         <td><code>D</code>
   141  *         <th scope="row"><code>D</code>
   142  *         <td>Day in year
   142  *         <td>Day in year
   143  *         <td><a href="#number">Number</a>
   143  *         <td><a href="#number">Number</a>
   144  *         <td><code>189</code>
   144  *         <td><code>189</code>
   145  *     <tr>
   145  *     <tr>
   146  *         <td><code>d</code>
   146  *         <th scope="row"><code>d</code>
   147  *         <td>Day in month
   147  *         <td>Day in month
   148  *         <td><a href="#number">Number</a>
   148  *         <td><a href="#number">Number</a>
   149  *         <td><code>10</code>
   149  *         <td><code>10</code>
   150  *     <tr>
   150  *     <tr>
   151  *         <td><code>F</code>
   151  *         <th scope="row"><code>F</code>
   152  *         <td>Day of week in month
   152  *         <td>Day of week in month
   153  *         <td><a href="#number">Number</a>
   153  *         <td><a href="#number">Number</a>
   154  *         <td><code>2</code>
   154  *         <td><code>2</code>
   155  *     <tr>
   155  *     <tr>
   156  *         <td><code>E</code>
   156  *         <th scope="row"><code>E</code>
   157  *         <td>Day name in week
   157  *         <td>Day name in week
   158  *         <td><a href="#text">Text</a>
   158  *         <td><a href="#text">Text</a>
   159  *         <td><code>Tuesday</code>; <code>Tue</code>
   159  *         <td><code>Tuesday</code>; <code>Tue</code>
   160  *     <tr>
   160  *     <tr>
   161  *         <td><code>u</code>
   161  *         <th scope="row"><code>u</code>
   162  *         <td>Day number of week (1 = Monday, ..., 7 = Sunday)
   162  *         <td>Day number of week (1 = Monday, ..., 7 = Sunday)
   163  *         <td><a href="#number">Number</a>
   163  *         <td><a href="#number">Number</a>
   164  *         <td><code>1</code>
   164  *         <td><code>1</code>
   165  *     <tr>
   165  *     <tr>
   166  *         <td><code>a</code>
   166  *         <th scope="row"><code>a</code>
   167  *         <td>Am/pm marker
   167  *         <td>Am/pm marker
   168  *         <td><a href="#text">Text</a>
   168  *         <td><a href="#text">Text</a>
   169  *         <td><code>PM</code>
   169  *         <td><code>PM</code>
   170  *     <tr>
   170  *     <tr>
   171  *         <td><code>H</code>
   171  *         <th scope="row"><code>H</code>
   172  *         <td>Hour in day (0-23)
   172  *         <td>Hour in day (0-23)
   173  *         <td><a href="#number">Number</a>
   173  *         <td><a href="#number">Number</a>
   174  *         <td><code>0</code>
   174  *         <td><code>0</code>
   175  *     <tr>
   175  *     <tr>
   176  *         <td><code>k</code>
   176  *         <th scope="row"><code>k</code>
   177  *         <td>Hour in day (1-24)
   177  *         <td>Hour in day (1-24)
   178  *         <td><a href="#number">Number</a>
   178  *         <td><a href="#number">Number</a>
   179  *         <td><code>24</code>
   179  *         <td><code>24</code>
   180  *     <tr>
   180  *     <tr>
   181  *         <td><code>K</code>
   181  *         <th scope="row"><code>K</code>
   182  *         <td>Hour in am/pm (0-11)
   182  *         <td>Hour in am/pm (0-11)
   183  *         <td><a href="#number">Number</a>
   183  *         <td><a href="#number">Number</a>
   184  *         <td><code>0</code>
   184  *         <td><code>0</code>
   185  *     <tr>
   185  *     <tr>
   186  *         <td><code>h</code>
   186  *         <th scope="row"><code>h</code>
   187  *         <td>Hour in am/pm (1-12)
   187  *         <td>Hour in am/pm (1-12)
   188  *         <td><a href="#number">Number</a>
   188  *         <td><a href="#number">Number</a>
   189  *         <td><code>12</code>
   189  *         <td><code>12</code>
   190  *     <tr>
   190  *     <tr>
   191  *         <td><code>m</code>
   191  *         <th scope="row"><code>m</code>
   192  *         <td>Minute in hour
   192  *         <td>Minute in hour
   193  *         <td><a href="#number">Number</a>
   193  *         <td><a href="#number">Number</a>
   194  *         <td><code>30</code>
   194  *         <td><code>30</code>
   195  *     <tr>
   195  *     <tr>
   196  *         <td><code>s</code>
   196  *         <th scope="row"><code>s</code>
   197  *         <td>Second in minute
   197  *         <td>Second in minute
   198  *         <td><a href="#number">Number</a>
   198  *         <td><a href="#number">Number</a>
   199  *         <td><code>55</code>
   199  *         <td><code>55</code>
   200  *     <tr>
   200  *     <tr>
   201  *         <td><code>S</code>
   201  *         <th scope="row"><code>S</code>
   202  *         <td>Millisecond
   202  *         <td>Millisecond
   203  *         <td><a href="#number">Number</a>
   203  *         <td><a href="#number">Number</a>
   204  *         <td><code>978</code>
   204  *         <td><code>978</code>
   205  *     <tr>
   205  *     <tr>
   206  *         <td><code>z</code>
   206  *         <th scope="row"><code>z</code>
   207  *         <td>Time zone
   207  *         <td>Time zone
   208  *         <td><a href="#timezone">General time zone</a>
   208  *         <td><a href="#timezone">General time zone</a>
   209  *         <td><code>Pacific Standard Time</code>; <code>PST</code>; <code>GMT-08:00</code>
   209  *         <td><code>Pacific Standard Time</code>; <code>PST</code>; <code>GMT-08:00</code>
   210  *     <tr>
   210  *     <tr>
   211  *         <td><code>Z</code>
   211  *         <th scope="row"><code>Z</code>
   212  *         <td>Time zone
   212  *         <td>Time zone
   213  *         <td><a href="#rfc822timezone">RFC 822 time zone</a>
   213  *         <td><a href="#rfc822timezone">RFC 822 time zone</a>
   214  *         <td><code>-0800</code>
   214  *         <td><code>-0800</code>
   215  *     <tr>
   215  *     <tr>
   216  *         <td><code>X</code>
   216  *         <th scope="row"><code>X</code>
   217  *         <td>Time zone
   217  *         <td>Time zone
   218  *         <td><a href="#iso8601timezone">ISO 8601 time zone</a>
   218  *         <td><a href="#iso8601timezone">ISO 8601 time zone</a>
   219  *         <td><code>-08</code>; <code>-0800</code>;  <code>-08:00</code>
   219  *         <td><code>-08</code>; <code>-0800</code>;  <code>-08:00</code>
   220  * </tbody>
   220  * </tbody>
   221  * </table>
   221  * </table>
   377  * <blockquote>
   377  * <blockquote>
   378  * <table class="striped">
   378  * <table class="striped">
   379  * <caption style="display:none">Examples of date and time patterns interpreted in the U.S. locale</caption>
   379  * <caption style="display:none">Examples of date and time patterns interpreted in the U.S. locale</caption>
   380  * <thead>
   380  * <thead>
   381  *     <tr>
   381  *     <tr>
   382  *         <th style="text-align:left">Date and Time Pattern
   382  *         <th scope="col" style="text-align:left">Date and Time Pattern
   383  *         <th style="text-align:left">Result
   383  *         <th scope="col" style="text-align:left">Result
   384  * </thead>
   384  * </thead>
   385  * <tbody>
   385  * <tbody>
   386  *     <tr>
   386  *     <tr>
   387  *         <td><code>"yyyy.MM.dd G 'at' HH:mm:ss z"</code>
   387  *         <th scope="row"><code>"yyyy.MM.dd G 'at' HH:mm:ss z"</code>
   388  *         <td><code>2001.07.04 AD at 12:08:56 PDT</code>
   388  *         <td><code>2001.07.04 AD at 12:08:56 PDT</code>
   389  *     <tr>
   389  *     <tr>
   390  *         <td><code>"EEE, MMM d, ''yy"</code>
   390  *         <th scope="row"><code>"EEE, MMM d, ''yy"</code>
   391  *         <td><code>Wed, Jul 4, '01</code>
   391  *         <td><code>Wed, Jul 4, '01</code>
   392  *     <tr>
   392  *     <tr>
   393  *         <td><code>"h:mm a"</code>
   393  *         <th scope="row"><code>"h:mm a"</code>
   394  *         <td><code>12:08 PM</code>
   394  *         <td><code>12:08 PM</code>
   395  *     <tr>
   395  *     <tr>
   396  *         <td><code>"hh 'o''clock' a, zzzz"</code>
   396  *         <th scope="row"><code>"hh 'o''clock' a, zzzz"</code>
   397  *         <td><code>12 o'clock PM, Pacific Daylight Time</code>
   397  *         <td><code>12 o'clock PM, Pacific Daylight Time</code>
   398  *     <tr>
   398  *     <tr>
   399  *         <td><code>"K:mm a, z"</code>
   399  *         <th scope="row"><code>"K:mm a, z"</code>
   400  *         <td><code>0:08 PM, PDT</code>
   400  *         <td><code>0:08 PM, PDT</code>
   401  *     <tr>
   401  *     <tr>
   402  *         <td><code>"yyyyy.MMMMM.dd GGG hh:mm aaa"</code>
   402  *         <th scope="row"><code>"yyyyy.MMMMM.dd GGG hh:mm aaa"</code>
   403  *         <td><code>02001.July.04 AD 12:08 PM</code>
   403  *         <td><code>02001.July.04 AD 12:08 PM</code>
   404  *     <tr>
   404  *     <tr>
   405  *         <td><code>"EEE, d MMM yyyy HH:mm:ss Z"</code>
   405  *         <th scope="row"><code>"EEE, d MMM yyyy HH:mm:ss Z"</code>
   406  *         <td><code>Wed, 4 Jul 2001 12:08:56 -0700</code>
   406  *         <td><code>Wed, 4 Jul 2001 12:08:56 -0700</code>
   407  *     <tr>
   407  *     <tr>
   408  *         <td><code>"yyMMddHHmmssZ"</code>
   408  *         <th scope="row"><code>"yyMMddHHmmssZ"</code>
   409  *         <td><code>010704120856-0700</code>
   409  *         <td><code>010704120856-0700</code>
   410  *     <tr>
   410  *     <tr>
   411  *         <td><code>"yyyy-MM-dd'T'HH:mm:ss.SSSZ"</code>
   411  *         <th scope="row"><code>"yyyy-MM-dd'T'HH:mm:ss.SSSZ"</code>
   412  *         <td><code>2001-07-04T12:08:56.235-0700</code>
   412  *         <td><code>2001-07-04T12:08:56.235-0700</code>
   413  *     <tr>
   413  *     <tr>
   414  *         <td><code>"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"</code>
   414  *         <th scope="row"><code>"yyyy-MM-dd'T'HH:mm:ss.SSSXXX"</code>
   415  *         <td><code>2001-07-04T12:08:56.235-07:00</code>
   415  *         <td><code>2001-07-04T12:08:56.235-07:00</code>
   416  *     <tr>
   416  *     <tr>
   417  *         <td><code>"YYYY-'W'ww-u"</code>
   417  *         <th scope="row"><code>"YYYY-'W'ww-u"</code>
   418  *         <td><code>2001-W27-3</code>
   418  *         <td><code>2001-W27-3</code>
   419  * </tbody>
   419  * </tbody>
   420  * </table>
   420  * </table>
   421  * </blockquote>
   421  * </blockquote>
   422  *
   422  *