src/java.base/share/classes/java/text/spi/DateFormatProvider.java
changeset 58242 94bb65cb37d3
parent 47216 71c04702a3d5
child 58288 48e480e56aad
equal deleted inserted replaced
58241:33de7752835c 58242:94bb65cb37d3
     1 /*
     1 /*
     2  * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
     2  * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
     4  *
     4  *
     5  * This code is free software; you can redistribute it and/or modify it
     5  * This code is free software; you can redistribute it and/or modify it
     6  * under the terms of the GNU General Public License version 2 only, as
     6  * under the terms of the GNU General Public License version 2 only, as
     7  * published by the Free Software Foundation.  Oracle designates this
     7  * published by the Free Software Foundation.  Oracle designates this
    52      *     {@link java.text.DateFormat#SHORT DateFormat.SHORT},
    52      *     {@link java.text.DateFormat#SHORT DateFormat.SHORT},
    53      *     {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
    53      *     {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
    54      *     {@link java.text.DateFormat#LONG DateFormat.LONG}, or
    54      *     {@link java.text.DateFormat#LONG DateFormat.LONG}, or
    55      *     {@link java.text.DateFormat#FULL DateFormat.FULL}.
    55      *     {@link java.text.DateFormat#FULL DateFormat.FULL}.
    56      * @param locale the desired locale.
    56      * @param locale the desired locale.
    57      * @exception IllegalArgumentException if <code>style</code> is invalid,
    57      * @throws    IllegalArgumentException if <code>style</code> is invalid,
    58      *     or if <code>locale</code> isn't
    58      *     or if <code>locale</code> isn't
    59      *     one of the locales returned from
    59      *     one of the locales returned from
    60      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    60      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    61      *     getAvailableLocales()}.
    61      *     getAvailableLocales()}.
    62      * @exception NullPointerException if <code>locale</code> is null
    62      * @throws    NullPointerException if <code>locale</code> is null
    63      * @return a time formatter.
    63      * @return a time formatter.
    64      * @see java.text.DateFormat#getTimeInstance(int, java.util.Locale)
    64      * @see java.text.DateFormat#getTimeInstance(int, java.util.Locale)
    65      */
    65      */
    66     public abstract DateFormat getTimeInstance(int style, Locale locale);
    66     public abstract DateFormat getTimeInstance(int style, Locale locale);
    67 
    67 
    72      *     {@link java.text.DateFormat#SHORT DateFormat.SHORT},
    72      *     {@link java.text.DateFormat#SHORT DateFormat.SHORT},
    73      *     {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
    73      *     {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
    74      *     {@link java.text.DateFormat#LONG DateFormat.LONG}, or
    74      *     {@link java.text.DateFormat#LONG DateFormat.LONG}, or
    75      *     {@link java.text.DateFormat#FULL DateFormat.FULL}.
    75      *     {@link java.text.DateFormat#FULL DateFormat.FULL}.
    76      * @param locale the desired locale.
    76      * @param locale the desired locale.
    77      * @exception IllegalArgumentException if <code>style</code> is invalid,
    77      * @throws    IllegalArgumentException if <code>style</code> is invalid,
    78      *     or if <code>locale</code> isn't
    78      *     or if <code>locale</code> isn't
    79      *     one of the locales returned from
    79      *     one of the locales returned from
    80      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    80      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
    81      *     getAvailableLocales()}.
    81      *     getAvailableLocales()}.
    82      * @exception NullPointerException if <code>locale</code> is null
    82      * @throws    NullPointerException if <code>locale</code> is null
    83      * @return a date formatter.
    83      * @return a date formatter.
    84      * @see java.text.DateFormat#getDateInstance(int, java.util.Locale)
    84      * @see java.text.DateFormat#getDateInstance(int, java.util.Locale)
    85      */
    85      */
    86     public abstract DateFormat getDateInstance(int style, Locale locale);
    86     public abstract DateFormat getDateInstance(int style, Locale locale);
    87 
    87 
    97      *     {@link java.text.DateFormat#SHORT DateFormat.SHORT},
    97      *     {@link java.text.DateFormat#SHORT DateFormat.SHORT},
    98      *     {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
    98      *     {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
    99      *     {@link java.text.DateFormat#LONG DateFormat.LONG}, or
    99      *     {@link java.text.DateFormat#LONG DateFormat.LONG}, or
   100      *     {@link java.text.DateFormat#FULL DateFormat.FULL}.
   100      *     {@link java.text.DateFormat#FULL DateFormat.FULL}.
   101      * @param locale the desired locale.
   101      * @param locale the desired locale.
   102      * @exception IllegalArgumentException if <code>dateStyle</code> or
   102      * @throws    IllegalArgumentException if <code>dateStyle</code> or
   103      *     <code>timeStyle</code> is invalid,
   103      *     <code>timeStyle</code> is invalid,
   104      *     or if <code>locale</code> isn't
   104      *     or if <code>locale</code> isn't
   105      *     one of the locales returned from
   105      *     one of the locales returned from
   106      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
   106      *     {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
   107      *     getAvailableLocales()}.
   107      *     getAvailableLocales()}.
   108      * @exception NullPointerException if <code>locale</code> is null
   108      * @throws    NullPointerException if <code>locale</code> is null
   109      * @return a date/time formatter.
   109      * @return a date/time formatter.
   110      * @see java.text.DateFormat#getDateTimeInstance(int, int, java.util.Locale)
   110      * @see java.text.DateFormat#getDateTimeInstance(int, int, java.util.Locale)
   111      */
   111      */
   112     public abstract DateFormat
   112     public abstract DateFormat
   113         getDateTimeInstance(int dateStyle, int timeStyle, Locale locale);
   113         getDateTimeInstance(int dateStyle, int timeStyle, Locale locale);