Module javafx.base
Package javafx.util.converter

# Class LocalDateStringConverter

java.lang.Object
javafx.util.StringConverter<LocalDate>
javafx.util.converter.LocalDateStringConverter

    public class LocalDateStringConverter
    extends StringConverter<LocalDate>

`StringConverter` implementation for `LocalDate` values.

Since:
  JavaFX 8u40
See Also:
  `LocalTimeStringConverter`, `LocalDateTimeStringConverter`

- ## Constructor Summary

  Constructors
  Constructor | Description
  --- | ---
  `LocalDateStringConverter()` | Create a `StringConverter` for `LocalDate` values, using a default formatter and parser based on `IsoChronology`, `FormatStyle.SHORT`, and the user's `Locale`.
  `LocalDateStringConverter​(DateTimeFormatter formatter, DateTimeFormatter parser)` | Create a {#link StringConverter} for `LocalDate` values using the supplied formatter and parser.
  `LocalDateStringConverter​(FormatStyle dateStyle)` | Create a `StringConverter` for `LocalDate` values, using a default formatter and parser based on `IsoChronology`, the specified `FormatStyle`, and the user's `Locale`.
  `LocalDateStringConverter​(FormatStyle dateStyle, Locale locale, Chronology chronology)` | Create a StringConverter for `LocalDate` values using a default formatter and parser, which will be based on the supplied `FormatStyle`, `Locale`, and `Chronology`.

- ## Method Summary

  ### Methods declared in class javafx.util.StringConverter

  `fromString, toString`

  ### Methods declared in class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## Constructor Details

  - ### LocalDateStringConverter

    public LocalDateStringConverter()
    Create a `StringConverter` for `LocalDate` values, using a default formatter and parser based on `IsoChronology`, `FormatStyle.SHORT`, and the user's `Locale`.

    This converter ensures symmetry between the toString() and fromString() methods. Many of the default locale based patterns used by `DateTimeFormatter` will display only two digits for the year when formatting to a string. This would cause a value like 1955 to be displayed as 55, which in turn would be parsed back as 2055. This converter modifies two-digit year patterns to always use four digits. The input parsing is not affected, so two digit year values can still be parsed leniently as expected in these locales.

  - ### LocalDateStringConverter

    public LocalDateStringConverter​(FormatStyle dateStyle)
    Create a `StringConverter` for `LocalDate` values, using a default formatter and parser based on `IsoChronology`, the specified `FormatStyle`, and the user's `Locale`.
    Parameters:
      `dateStyle` - The `FormatStyle` that will be used by the default formatter and parser. If null then `FormatStyle.SHORT` will be used.

  - ### LocalDateStringConverter

    public LocalDateStringConverter​(DateTimeFormatter formatter, DateTimeFormatter parser)
    Create a {#link StringConverter} for `LocalDate` values using the supplied formatter and parser.

    For example, to use a fixed pattern for converting both ways:

    >      String pattern = "yyyy-MM-dd";
    >      DateTimeFormatter formatter = DateTimeFormatter.ofPattern(pattern);
    >      StringConverter<LocalDate> converter =
    >          DateTimeStringConverter.getLocalDateStringConverter(formatter, null);

    Note that the formatter and parser can be created to handle non-default `Locale` and `Chronology` as needed.
    Parameters:
      `formatter` - An instance of `DateTimeFormatter` that will be used for formatting by the toString() method. If null then a default formatter will be used.
      `parser` - An instance of `DateTimeFormatter` that will be used for parsing by the fromString() method. This can be identical to formatter. If null then formatter will be used, and if that is also null, then a default parser will be used.

  - ### LocalDateStringConverter

    public LocalDateStringConverter​(FormatStyle dateStyle, Locale locale, Chronology chronology)
    Create a StringConverter for `LocalDate` values using a default formatter and parser, which will be based on the supplied `FormatStyle`, `Locale`, and `Chronology`.
    Parameters:
      `dateStyle` - The `FormatStyle` that will be used by the default formatter and parser. If null then `FormatStyle.SHORT` will be used.
      `locale` - The `Locale` that will be used by the default formatter and parser. If null then `Locale.getDefault(Locale.Category.FORMAT)` will be used.
      `chronology` - The `Chronology` that will be used by the default formatter and parser. If null then `IsoChronology.INSTANCE` will be used.