LocalizedDateTimeFormatters.java

  1. /*
  2.  * *********************************************************************************************************************
  3.  *
  4.  * TheseFoolishThings: Miscellaneous utilities
  5.  * http://tidalwave.it/projects/thesefoolishthings
  6.  *
  7.  * Copyright (C) 2009 - 2023 by Tidalwave s.a.s. (http://tidalwave.it)
  8.  *
  9.  * *********************************************************************************************************************
  10.  *
  11.  * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
  12.  * the License. You may obtain a copy of the License at
  13.  *
  14.  *     http://www.apache.org/licenses/LICENSE-2.0
  15.  *
  16.  * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
  17.  * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.  See the License for the
  18.  * specific language governing permissions and limitations under the License.
  19.  *
  20.  * *********************************************************************************************************************
  21.  *
  22.  * git clone https://bitbucket.org/tidalwave/thesefoolishthings-src
  23.  * git clone https://github.com/tidalwave-it/thesefoolishthings-src
  24.  *
  25.  * *********************************************************************************************************************
  26.  */
  27. package it.tidalwave.util;

  28. import javax.annotation.Nonnull;
  29. import java.time.format.DateTimeFormatter;
  30. import java.time.format.FormatStyle;
  31. import java.util.Locale;
  32. import lombok.AccessLevel;
  33. import lombok.NoArgsConstructor;

  34. /***********************************************************************************************************************
  35.  *
  36.  * A factory class for localized {@link DateTimeFormatter}s in various flavours, specified by the {@link FormatStyle}.
  37.  * This class is especially useful for migration to JDK 9+, where the default behaviour of
  38.  * {@code DateTimeFormatter.ofLocalizedDate/DateTime(...)} has changed.
  39.  *
  40.  * At the moment only locales for English and Italian are supported.
  41.  *
  42.  * @since   3.1-ALPHA-4
  43.  * @author  Fabrizio Giudici
  44.  *
  45.  **********************************************************************************************************************/
  46. @NoArgsConstructor(access = AccessLevel.PRIVATE)
  47. public final class LocalizedDateTimeFormatters
  48.   {
  49.     /*******************************************************************************************************************
  50.      *
  51.      * Returns a formatter.
  52.      *
  53.      * @param   style   the style
  54.      * @param   locale  the locale
  55.      * @return          the formatter
  56.      *
  57.      ******************************************************************************************************************/
  58.     @Nonnull
  59.     public static DateTimeFormatter getDateTimeFormatterFor (@Nonnull final FormatStyle style,
  60.                                                              @Nonnull final Locale locale)
  61.       {
  62.         final var resourceName = "dateTimeFormatterPattern." + style.name();
  63.         final var pattern = BundleUtilities.getMessage(LocalizedDateTimeFormatters.class, locale, resourceName);
  64.         return DateTimeFormatter.ofPattern(pattern).withLocale(locale);
  65.       }
  66.   }