com.github.lgooddatepicker.zinternaltools.ExtraDateStrings Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of LGoodDatePicker Show documentation
Java 8 Swing Date Picker. Easy to use, good looking, nice features, and localized. Uses the JSR-310 standard.
There is a newer version: 11.2.1
package com.github.lgooddatepicker.zinternaltools;

import java.text.DateFormatSymbols;
import java.time.Month;
import java.time.format.DateTimeFormatter;
import java.time.format.DateTimeFormatterBuilder;
import java.time.format.TextStyle;
import java.util.ArrayList;
import java.util.Locale;

/**
 * ExtraDateStrings, This class holds extra date strings. This includes: # Formats for parsing dates
 * in a particular language. # Overridden month names for particular locales. All the fields and
 * functions are static.
 */
public class ExtraDateStrings {

    /**
     * extraParsingFormatsForLanguage_en, This is a constant list of extra parsing formats, which
     * are used for parsing dates in an English locale.
     */
    final static private String[] extraParsingFormatsForLanguage_en = new String[]{
        "M/d/u", "dMMMuu", "dMMMuuuu", "d MMM uu", "d MMM uuuu", "MMM d, u", "MMM d u",
        "MMM d, yyyy G"};

    /**
     * extraParsingFormatsForLanguage_ru, This is a constant list of extra parsing formats, which
     * are used for parsing dates in a Russian locale.
     */
    final static private String[] extraParsingFormatsForLanguage_ru = new String[]{
        "d MMM uuuu"};

    /**
     * monthsNamesForLanguage_ru, This is a constant list of "standalone" month names, for the
     * Russian locale. This was previously used to supply the Russian month names, but now that this
     * class has a generalized solution for getting the standalone month names in all languages,
     * this array should only be used for visual reference. This can be used for comparison to
     * ensure that the general solution is functioning correctly.
     */
    final static public String[] monthsNamesForLanguage_ru = new String[]{"январь", "февраль",
        "март", "апрель", "май", "июнь", "июль", "август", "сентябрь", "октябрь", "ноябрь", "декабрь"};

    /**
     * getExtraParsingFormatsForLocale, This will return a list of extra parsing formatters for the
     * specified locale. If no extra formatters are found, then this will return an empty list.
     * (This will never return null.)
     */
    public static ArrayList getExtraParsingFormatsForLocale(Locale locale) {
        // Create some variables that we will need.
        String language = locale.getLanguage();
        String[] definedFormats = null;

        // Get the list of extra parsing formats for the language of the locale.
        if ("en".equals(language)) {
            definedFormats = extraParsingFormatsForLanguage_en;
        }
        if ("ru".equals(language)) {
            definedFormats = extraParsingFormatsForLanguage_ru;
        }

        // If no extra parsing formats were found, then return an empty list.
        ArrayList extraParsingFormatters = new ArrayList();
        if (definedFormats == null) {
            return extraParsingFormatters;
        }

        // Create the parsing formatters from the defined formats, and add them to the results list.
        DateTimeFormatter formatter;
        for (String formatString : definedFormats) {
            formatter = new DateTimeFormatterBuilder().parseLenient().parseCaseInsensitive().
                    appendPattern(formatString).toFormatter(locale);
            extraParsingFormatters.add(formatter);
        }

        // Return the results.
        return extraParsingFormatters;
    }

    /**
     * getDefaultStandaloneLongMonthNamesForLocale, This will return a list of capitalized,
     * translated, standalone month names for the specified locale. This function will always return
     * a list with 12 elements, and each element will always contain a string. This will never
     * return a null array, or any null elements.
     *
     * Implementation note: it was previously required to override the month names in certain
     * languages such as Russian, to get the proper grammar. At this point, a generalized solution
     * has been implemented for all languages. It is assumed that this solution is working
     * correctly, unless and until someone reports that it is not working correctly for their
     * language.
     */
    public static String[] getDefaultStandaloneLongMonthNamesForLocale(Locale locale) {
        // Get the standalone version of the month names for the specified language.
        String[] monthNames = getStandaloneMonthNamesArray(locale, true, false);
        // Return the array of month names.
        return monthNames;
    }

    public static String[] getDefaultStandaloneShortMonthNamesForLocale(Locale locale) {
        // Get the standalone version of the month names for the specified language.
        String[] monthNames = getStandaloneMonthNamesArray(locale, true, true);
        // Return the array of month names.
        return monthNames;
    }

    /**
     * getStandaloneMonthName, This returns a "standalone version" month name for the specified
     * month, in the specified locale. In some languages, including Russian and Czech, the
     * standalone version of the month name is different from the version of the month name you
     * would use as part of a full date. (Is different from the formatting version).
     *
     * This tries to get the standalone version first. If no mapping is found for a standalone
     * version (Presumably because the supplied language has no standalone version), then this will
     * return the formatting version of the month name.
     */
    private static String getStandaloneMonthName(Month month, Locale locale, boolean capitalize,
            boolean shortVersion) {
        // Attempt to get the standalone version of the month name.
        TextStyle style = (shortVersion) ? TextStyle.SHORT_STANDALONE : TextStyle.FULL_STANDALONE;
        String monthName = month.getDisplayName(style, locale);
        String monthNumber = "" + month.getValue();
        // If no mapping was found, then get the "formatting version" of the month name.
        if (monthName.equals(monthNumber)) {
            DateFormatSymbols dateSymbols = DateFormatSymbols.getInstance(locale);
            if (shortVersion) {
                monthName = dateSymbols.getShortMonths()[month.getValue() - 1];
            } else {
                monthName = dateSymbols.getMonths()[month.getValue() - 1];
            }
        }
        // If needed, capitalize the month name.
        if ((capitalize) && (monthName != null) && (monthName.length() > 0)) {
            monthName = monthName.substring(0, 1).toUpperCase(locale) + monthName.substring(1);
        }
        return monthName;
    }

    /**
     * getStandaloneMonthNamesArray, This returns an array with the standalone version of all the
     * full month names.
     */
    private static String[] getStandaloneMonthNamesArray(Locale locale, boolean capitalize,
            boolean shortVersion) {
        Month[] monthEnums = Month.values();
        ArrayList monthNamesArrayList = new ArrayList();
        for (Month monthEnum : monthEnums) {
            monthNamesArrayList.add(getStandaloneMonthName(monthEnum, locale, capitalize, shortVersion));
        }
        // Convert the arraylist to a string array, and return the array.
        String[] monthNames = monthNamesArrayList.toArray(new String[]{});
        return monthNames;
    }

    /**
     * getFormattingMonthName, This returns a "formatting version" month name for the specified
     * month, in the specified locale. In some languages, including Russian and Czech, the
     * standalone version of the month name is different from the version of the month name you
     * would use as part of a full date. (Is different from the formatting version).
     */
    private static String getFormattingMonthName(Month month, Locale locale, boolean capitalize,
            boolean shortVersion) {
        // Get the "formatting version" of the month name.
        DateFormatSymbols dateSymbols = DateFormatSymbols.getInstance(locale);
        String monthName;
        if (shortVersion) {
            monthName = dateSymbols.getShortMonths()[month.getValue() - 1];
        } else {
            monthName = dateSymbols.getMonths()[month.getValue() - 1];
        }
        // If needed, capitalize the month name.
        if ((capitalize) && (monthName != null) && (monthName.length() > 0)) {
            monthName = monthName.substring(0, 1).toUpperCase(locale) + monthName.substring(1);
        }
        return monthName;
    }

    /**
     * getFormattingMonthNamesArray, This returns an array with the translated, formatting version
     * of the month names for the specified locale. (The "formatting version" of the month names can
     * be different from the standalone version in some locales, including Russian and Czech. The
     * formatting version would be used in a formatted date, and the standalone version would be
     * used if the month is being specified by itself.)
     *
     * capitalize: This specifies whether the month name should be capitalized or not capitalized.
     * shortVersion: This specifies whether the month names should be the short, or long versions of
     * the formatting month names.
     */
    public static String[] getFormattingMonthNamesArray(Locale locale, boolean capitalize,
            boolean shortVersion) {
        Month[] monthEnums = Month.values();
        ArrayList monthNamesArrayList = new ArrayList();
        for (Month monthEnum : monthEnums) {
            monthNamesArrayList.add(getFormattingMonthName(
                    monthEnum, locale, capitalize, shortVersion));
        }
        // Convert the arraylist to a string array, and return the array.
        String[] monthNames = monthNamesArrayList.toArray(new String[]{});
        return monthNames;
    }
}