| /* |
| * Copyright 2011 Google Inc. |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); you may not |
| * use this file except in compliance with the License. You may obtain a copy of |
| * the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT |
| * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the |
| * License for the specific language governing permissions and limitations under |
| * the License. |
| */ |
| package com.google.gwt.i18n.shared; |
| |
| /** |
| * Information required for formatting and parsing localized date/time values. |
| * |
| * <p>Implementors should subclass {@link DefaultDateTimeFormatInfo} so when |
| * methods are added they will get reasonable defaults and not break. See the |
| * same class for example values returned by these methods. |
| */ |
| public interface DateTimeFormatInfo { |
| |
| /** |
| * Returns array of strings containing abbreviations for Ante Meridiem and |
| * Post Meridiem. |
| */ |
| String[] ampms(); |
| |
| /** |
| * Returns a safe default date format. |
| */ |
| String dateFormat(); |
| |
| /** |
| * Returns a "full" date format. |
| */ |
| String dateFormatFull(); |
| |
| /** |
| * Returns a "long" date format. |
| */ |
| String dateFormatLong(); |
| |
| /** |
| * Returns a "medium" date format. |
| */ |
| String dateFormatMedium(); |
| |
| /** |
| * Returns a "short" date format. |
| */ |
| String dateFormatShort(); |
| |
| /** |
| * Returns a date/time format from a date format pattern and a time format |
| * pattern, using the locale default joining. |
| * |
| * @param timePattern the time pattern String |
| * @param datePattern the data pattern String |
| */ |
| String dateTime(String timePattern, String datePattern); |
| |
| /** |
| * Returns a date/time format from a date format pattern and a time format |
| * pattern, using "full" joining. |
| * |
| * @param timePattern the time pattern String |
| * @param datePattern the data pattern String |
| */ |
| String dateTimeFull(String timePattern, String datePattern); |
| |
| /** |
| * Returns a date/time format from a date format pattern and a time format |
| * pattern, using "full" joining. |
| * |
| * @param timePattern the time pattern String |
| * @param datePattern the data pattern String |
| */ |
| String dateTimeLong(String timePattern, String datePattern); |
| |
| /** |
| * Returns a date/time format from a date format pattern and a time format |
| * pattern, using "full" joining. |
| * |
| * @param timePattern the time pattern String |
| * @param datePattern the data pattern String |
| */ |
| String dateTimeMedium(String timePattern, String datePattern); |
| |
| /** |
| * Returns a date/time format from a date format pattern and a time format |
| * pattern, using "full" joining. |
| * |
| * @param timePattern the time pattern String |
| * @param datePattern the data pattern String |
| */ |
| String dateTimeShort(String timePattern, String datePattern); |
| |
| /** |
| * Returns an array of the full era names. |
| */ |
| String[] erasFull(); |
| |
| /** |
| * Returns abbreviations of the era names. |
| */ |
| String[] erasShort(); |
| |
| /** |
| * Returns the day which generally comes first in a weekly calendar view, as |
| * an index into the return value of {@link #weekdaysFull()}. |
| */ |
| int firstDayOfTheWeek(); |
| |
| /** |
| * Returns localized format equivalent to the "d" skeleton pattern. |
| */ |
| String formatDay(); |
| |
| /** |
| * Returns localized format equivalent to the "hm" skeleton pattern. |
| */ |
| String formatHour12Minute(); |
| |
| /** |
| * Returns localized format equivalent to the "hms" skeleton pattern. |
| */ |
| String formatHour12MinuteSecond(); |
| |
| /** |
| * Returns localized format equivalent to the "Hm" skeleton pattern. |
| */ |
| String formatHour24Minute(); |
| |
| /** |
| * Returns localized format equivalent to the "Hms" skeleton pattern. |
| */ |
| String formatHour24MinuteSecond(); |
| |
| /** |
| * Returns localized format equivalent to the "ms" skeleton pattern. |
| */ |
| String formatMinuteSecond(); |
| |
| /** |
| * Returns localized format equivalent to the "MMM" skeleton pattern. |
| */ |
| String formatMonthAbbrev(); |
| |
| /** |
| * Returns localized format equivalent to the "MMMd" skeleton pattern. |
| */ |
| String formatMonthAbbrevDay(); |
| |
| /** |
| * Returns localized format equivalent to the "MMMM" skeleton pattern. |
| */ |
| String formatMonthFull(); |
| |
| /** |
| * Returns localized format equivalent to the "MMMMd" skeleton pattern. |
| */ |
| String formatMonthFullDay(); |
| |
| /** |
| * Returns localized format equivalent to the "MMMMEEEEd" skeleton pattern. |
| */ |
| String formatMonthFullWeekdayDay(); |
| |
| /** |
| * Returns localized format equivalent to the "Md" skeleton pattern. |
| */ |
| String formatMonthNumDay(); |
| |
| /** |
| * Returns localized format equivalent to the "y" skeleton pattern. |
| */ |
| String formatYear(); |
| |
| /** |
| * Returns localized format equivalent to the "yMMM" skeleton pattern. |
| */ |
| String formatYearMonthAbbrev(); |
| |
| /** |
| * Returns localized format equivalent to the "yMMMd" skeleton pattern. |
| */ |
| String formatYearMonthAbbrevDay(); |
| |
| /** |
| * Returns localized format equivalent to the "yMMMM" skeleton pattern. |
| */ |
| String formatYearMonthFull(); |
| |
| /** |
| * Returns localized format equivalent to the "yMMMMd" skeleton pattern. |
| */ |
| String formatYearMonthFullDay(); |
| |
| /** |
| * Returns localized format equivalent to the "yM" skeleton pattern. |
| */ |
| String formatYearMonthNum(); |
| |
| /** |
| * Returns localized format equivalent to the "yMd" skeleton pattern. |
| */ |
| String formatYearMonthNumDay(); |
| |
| /** |
| * Returns localized format equivalent to the "yMMMEEEd" skeleton pattern. |
| */ |
| String formatYearMonthWeekdayDay(); |
| |
| /** |
| * Returns localized format equivalent to the "yQQQQ" skeleton pattern. |
| */ |
| String formatYearQuarterFull(); |
| |
| /** |
| * Returns localized format equivalent to the "yQ" skeleton pattern. |
| */ |
| String formatYearQuarterShort(); |
| |
| /** |
| * Returns an array of full month names. |
| */ |
| String[] monthsFull(); |
| |
| /** |
| * Returns an array of month names for use in a stand-alone context. |
| */ |
| String[] monthsFullStandalone(); |
| |
| /** |
| * Returns an array of the shortest abbreviations for months, typically a |
| * single character and not guaranteed to be unique. |
| */ |
| String[] monthsNarrow(); |
| |
| /** |
| * Returns an array of the shortest abbreviations for months suitable for use |
| * in a stand-alone context, typically a single character and not guaranteed |
| * to be unique. |
| */ |
| String[] monthsNarrowStandalone(); |
| |
| /** |
| * Returns an array of month abbreviations. |
| */ |
| String[] monthsShort(); |
| |
| /** |
| * Returns an array of month abbreviations, suitable for use in a stand-alone |
| * context. |
| */ |
| String[] monthsShortStandalone(); |
| |
| /** |
| * Returns an array of full quarter names. |
| */ |
| String[] quartersFull(); |
| |
| /** |
| * Returns an array of abbreviations for quarters. |
| */ |
| String[] quartersShort(); |
| |
| /** |
| * Returns a safe default time format. |
| */ |
| String timeFormat(); |
| |
| /** |
| * Returns a "full" time format. |
| */ |
| String timeFormatFull(); |
| |
| /** |
| * Returns a "long" time format. |
| */ |
| String timeFormatLong(); |
| |
| /** |
| * Returns a "medium" time format. |
| */ |
| String timeFormatMedium(); |
| |
| /** |
| * Returns a "short" time format. |
| */ |
| String timeFormatShort(); |
| |
| /** |
| * Returns an array of the full names of weekdays. |
| */ |
| String[] weekdaysFull(); |
| |
| /** |
| * Returns an array of the full names of weekdays, suitable for use in a |
| * stand-alone context. |
| */ |
| String[] weekdaysFullStandalone(); |
| |
| /** |
| * Returns an array of the shortest abbreviations for weekdays, typically a |
| * single character and not guaranteed to be unique. |
| */ |
| String[] weekdaysNarrow(); |
| |
| /** |
| * Returns an array of the shortest abbreviations for weekdays suitable for |
| * use in a stand-alone context, typically a single character and not |
| * guaranteed to be unique. |
| */ |
| String[] weekdaysNarrowStandalone(); |
| |
| /** |
| * Returns an array of abbreviations for weekdays. |
| */ |
| String[] weekdaysShort(); |
| |
| /** |
| * Returns an array of abbreviations for weekdays, suitable for use in a |
| * stand-alone context. |
| */ |
| String[] weekdaysShortStandalone(); |
| |
| /** |
| * Returns the day which ends the weekend, as an index into the return value |
| * of {@link #weekdaysFull()}. |
| * |
| * <p>Note that this value may be numerically less than |
| * {@link #weekendStart()} - for example, {@link #weekendStart()} of 6 and |
| * {@link #weekendEnd()} of 0 means Saturday and Sunday are the weekend. |
| */ |
| int weekendEnd(); |
| |
| /** |
| * Returns the day which starts the weekend, as an index into the return value |
| * of {@link #weekdaysFull()}. |
| */ |
| int weekendStart(); |
| } |