You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
115 lines
4.2 KiB
115 lines
4.2 KiB
/*
|
|
* Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
|
|
* ORACLE PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*
|
|
*/
|
|
|
|
package java.text.spi;
|
|
|
|
import java.text.DateFormat;
|
|
import java.util.Locale;
|
|
import java.util.spi.LocaleServiceProvider;
|
|
|
|
/**
|
|
* An abstract class for service providers that
|
|
* provide concrete implementations of the
|
|
* {@link java.text.DateFormat DateFormat} class.
|
|
*
|
|
* @since 1.6
|
|
*/
|
|
public abstract class DateFormatProvider extends LocaleServiceProvider {
|
|
|
|
/**
|
|
* Sole constructor. (For invocation by subclass constructors, typically
|
|
* implicit.)
|
|
*/
|
|
protected DateFormatProvider() {
|
|
}
|
|
|
|
/**
|
|
* Returns a new <code>DateFormat</code> instance which formats time
|
|
* with the given formatting style for the specified locale.
|
|
* @param style the given formatting style. Either one of
|
|
* {@link java.text.DateFormat#SHORT DateFormat.SHORT},
|
|
* {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
|
|
* {@link java.text.DateFormat#LONG DateFormat.LONG}, or
|
|
* {@link java.text.DateFormat#FULL DateFormat.FULL}.
|
|
* @param locale the desired locale.
|
|
* @exception IllegalArgumentException if <code>style</code> is invalid,
|
|
* or if <code>locale</code> isn't
|
|
* one of the locales returned from
|
|
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
|
|
* getAvailableLocales()}.
|
|
* @exception NullPointerException if <code>locale</code> is null
|
|
* @return a time formatter.
|
|
* @see java.text.DateFormat#getTimeInstance(int, java.util.Locale)
|
|
*/
|
|
public abstract DateFormat getTimeInstance(int style, Locale locale);
|
|
|
|
/**
|
|
* Returns a new <code>DateFormat</code> instance which formats date
|
|
* with the given formatting style for the specified locale.
|
|
* @param style the given formatting style. Either one of
|
|
* {@link java.text.DateFormat#SHORT DateFormat.SHORT},
|
|
* {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
|
|
* {@link java.text.DateFormat#LONG DateFormat.LONG}, or
|
|
* {@link java.text.DateFormat#FULL DateFormat.FULL}.
|
|
* @param locale the desired locale.
|
|
* @exception IllegalArgumentException if <code>style</code> is invalid,
|
|
* or if <code>locale</code> isn't
|
|
* one of the locales returned from
|
|
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
|
|
* getAvailableLocales()}.
|
|
* @exception NullPointerException if <code>locale</code> is null
|
|
* @return a date formatter.
|
|
* @see java.text.DateFormat#getDateInstance(int, java.util.Locale)
|
|
*/
|
|
public abstract DateFormat getDateInstance(int style, Locale locale);
|
|
|
|
/**
|
|
* Returns a new <code>DateFormat</code> instance which formats date and time
|
|
* with the given formatting style for the specified locale.
|
|
* @param dateStyle the given date formatting style. Either one of
|
|
* {@link java.text.DateFormat#SHORT DateFormat.SHORT},
|
|
* {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
|
|
* {@link java.text.DateFormat#LONG DateFormat.LONG}, or
|
|
* {@link java.text.DateFormat#FULL DateFormat.FULL}.
|
|
* @param timeStyle the given time formatting style. Either one of
|
|
* {@link java.text.DateFormat#SHORT DateFormat.SHORT},
|
|
* {@link java.text.DateFormat#MEDIUM DateFormat.MEDIUM},
|
|
* {@link java.text.DateFormat#LONG DateFormat.LONG}, or
|
|
* {@link java.text.DateFormat#FULL DateFormat.FULL}.
|
|
* @param locale the desired locale.
|
|
* @exception IllegalArgumentException if <code>dateStyle</code> or
|
|
* <code>timeStyle</code> is invalid,
|
|
* or if <code>locale</code> isn't
|
|
* one of the locales returned from
|
|
* {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
|
|
* getAvailableLocales()}.
|
|
* @exception NullPointerException if <code>locale</code> is null
|
|
* @return a date/time formatter.
|
|
* @see java.text.DateFormat#getDateTimeInstance(int, int, java.util.Locale)
|
|
*/
|
|
public abstract DateFormat
|
|
getDateTimeInstance(int dateStyle, int timeStyle, Locale locale);
|
|
}
|