0N/A/*
2362N/A * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
0N/A *
0N/A * This code is free software; you can redistribute it and/or modify it
0N/A * under the terms of the GNU General Public License version 2 only, as
2362N/A * published by the Free Software Foundation. Oracle designates this
0N/A * particular file as subject to the "Classpath" exception as provided
2362N/A * by Oracle in the LICENSE file that accompanied this code.
0N/A *
0N/A * This code is distributed in the hope that it will be useful, but WITHOUT
0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
0N/A * version 2 for more details (a copy is included in the LICENSE file that
0N/A * accompanied this code).
0N/A *
0N/A * You should have received a copy of the GNU General Public License version
0N/A * 2 along with this work; if not, write to the Free Software Foundation,
0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
0N/A *
2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
2362N/A * or visit www.oracle.com if you need additional information or have any
2362N/A * questions.
0N/A */
0N/A
0N/Apackage java.util.spi;
0N/A
0N/Aimport java.util.Locale;
0N/A
0N/A/**
0N/A * An abstract class for service providers that
0N/A * provide localized time zone names for the
0N/A * {@link java.util.TimeZone TimeZone} class.
0N/A * The localized time zone names available from the implementations of
0N/A * this class are also the source for the
0N/A * {@link java.text.DateFormatSymbols#getZoneStrings()
0N/A * DateFormatSymbols.getZoneStrings()} method.
0N/A *
0N/A * @since 1.6
0N/A */
0N/Apublic abstract class TimeZoneNameProvider extends LocaleServiceProvider {
0N/A
0N/A /**
0N/A * Sole constructor. (For invocation by subclass constructors, typically
0N/A * implicit.)
0N/A */
0N/A protected TimeZoneNameProvider() {
0N/A }
0N/A
0N/A /**
0N/A * Returns a name for the given time zone ID that's suitable for
0N/A * presentation to the user in the specified locale. The given time
0N/A * zone ID is "GMT" or one of the names defined using "Zone" entries
0N/A * in the "tz database", a public domain time zone database at
0N/A * <a href="ftp://elsie.nci.nih.gov/pub/">ftp://elsie.nci.nih.gov/pub/</a>.
0N/A * The data of this database is contained in a file whose name starts with
0N/A * "tzdata", and the specification of the data format is part of the zic.8
0N/A * man page, which is contained in a file whose name starts with "tzcode".
0N/A * <p>
0N/A * If <code>daylight</code> is true, the method should return a name
0N/A * appropriate for daylight saving time even if the specified time zone
0N/A * has not observed daylight saving time in the past.
0N/A *
0N/A * @param ID a time zone ID string
0N/A * @param daylight if true, return the daylight saving name.
0N/A * @param style either {@link java.util.TimeZone#LONG TimeZone.LONG} or
0N/A * {@link java.util.TimeZone#SHORT TimeZone.SHORT}
0N/A * @param locale the desired locale
0N/A * @return the human-readable name of the given time zone in the
0N/A * given locale, or null if it's not available.
0N/A * @exception IllegalArgumentException if <code>style</code> is invalid,
0N/A * or <code>locale</code> isn't one of the locales returned from
0N/A * {@link java.util.spi.LocaleServiceProvider#getAvailableLocales()
0N/A * getAvailableLocales()}.
0N/A * @exception NullPointerException if <code>ID</code> or <code>locale</code>
0N/A * is null
0N/A * @see java.util.TimeZone#getDisplayName(boolean, int, java.util.Locale)
0N/A */
0N/A public abstract String getDisplayName(String ID, boolean daylight, int style, Locale locale);
0N/A}