Класс DatePicker

public final ObjectProperty<Callback<DatePicker,DateCell>> dayCellFactoryProperty

 final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
     public DateCell call(final DatePicker datePicker) {
         return new DateCell() {
             @Override public void updateItem(LocalDate item, boolean empty) {
                 super.updateItem(item, empty);

                 if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                     setTooltip(new Tooltip("Happy Birthday!"));
                     setStyle("-fx-background-color: #ff4444;");
                 }
                 if (item.equals(LocalDate.now().plusDays(1))) {
                     // Tomorrow is too soon.
                     setDisable(true);
                 }
             }
         };
     }
 };
 datePicker.setDayCellFactory(dayCellFactory);
 

Значение по умолчанию:

null

См. также:

• getDayCellFactory()
• setDayCellFactory(Callback)
• dayCellFactoryProperty()

public final ObjectProperty<Chronology> chronologyProperty

См. также:

• getChronology()
• setChronology(Chronology)
• chronologyProperty()

public final BooleanProperty showWeekNumbersProperty

См. также:

• isShowWeekNumbers()
• setShowWeekNumbers(boolean)
• showWeekNumbersProperty()

public final ObjectProperty<StringConverter<LocalDate>> converterProperty

 datePicker.setConverter(new StringConverter<LocalDate>() {
     String pattern = "yyyy-MM-dd";
     DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);

     {
         datePicker.setPromptText(pattern.toLowerCase());
     }

     @Override public String toString(LocalDate date) {
         if (date != null) {
             return dateFormatter.format(date);
         } else {
             return "";
         }
     }

     @Override public LocalDate fromString(String string) {
         if (string != null && !string.isEmpty()) {
             return LocalDate.parse(string, dateFormatter);
         } else {
             return null;
         }
     }
 });
 

   final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
   datePicker.setConverter(new StringConverter<LocalDate>() {
       @Override public String toString(LocalDate value) {
           return defaultConverter.toString(value);
       }

       @Override public LocalDate fromString(String text) {
           try {
               return defaultConverter.fromString(text);
           } catch (DateTimeParseException ex) {
               System.err.println("HelloDatePicker: "+ex.getMessage());
               throw ex;
           }
       }
   });
 

   @Override public LocalDate fromString(String text) {
       if (text != null && !text.isEmpty()) {
           Locale locale = Locale.getDefault(Locale.Category.FORMAT);
           Chronology chrono = datePicker.getChronology();
           String pattern =
               DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                    null, chrono, locale);
           String prePattern = pattern.substring(0, pattern.indexOf("y"));
           String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
           int baseYear = LocalDate.now().getYear() - 99;
           DateTimeFormatter df = new DateTimeFormatterBuilder()
                       .parseLenient()
                       .appendPattern(prePattern)
                       .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                       .appendPattern(postPattern)
                       .toFormatter();
           return LocalDate.from(chrono.date(df.parse(text)));
       } else {
           return null;
       }
   }
 

См. также:

• getConverter()
• setConverter(StringConverter)
• converterProperty()

public final ReadOnlyObjectProperty<TextField> editorProperty

См. также:

• getEditor()
• editorProperty()

public DatePicker()

public DatePicker(LocalDate localDate)

Параметры:

localDate - дата, которая будет установлена в качестве текущей выбранной даты в DatePicker. Может быть null.

public final void setDayCellFactory(Callback<DatePicker,DateCell> value)

Описание свойства:

Можно указать пользовательскую фабрику ячеек для настройки отдельных ячеек дней в всплывающем окне DatePicker. Дополнительную информацию о фабриках ячеек см. в DateCell и Cell. Пример:

 final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
     public DateCell call(final DatePicker datePicker) {
         return new DateCell() {
             @Override public void updateItem(LocalDate item, boolean empty) {
                 super.updateItem(item, empty);

                 if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                     setTooltip(new Tooltip("Happy Birthday!"));
                     setStyle("-fx-background-color: #ff4444;");
                 }
                 if (item.equals(LocalDate.now().plusDays(1))) {
                     // Tomorrow is too soon.
                     setDisable(true);
                 }
             }
         };
     }
 };
 datePicker.setDayCellFactory(dayCellFactory);
 

Значение по умолчанию:

null

Параметры:

value - значение для свойства dayCellFactory

См. также:

• getDayCellFactory()
• dayCellFactoryProperty()

public final Callback<DatePicker,DateCell> getDayCellFactory()

Описание свойства:

Можно указать пользовательскую фабрику ячеек для настройки отдельных ячеек дней в всплывающем окне DatePicker. Дополнительную информацию о фабриках ячеек см. в DateCell и Cell. Пример:

 final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
     public DateCell call(final DatePicker datePicker) {
         return new DateCell() {
             @Override public void updateItem(LocalDate item, boolean empty) {
                 super.updateItem(item, empty);

                 if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                     setTooltip(new Tooltip("Happy Birthday!"));
                     setStyle("-fx-background-color: #ff4444;");
                 }
                 if (item.equals(LocalDate.now().plusDays(1))) {
                     // Tomorrow is too soon.
                     setDisable(true);
                 }
             }
         };
     }
 };
 datePicker.setDayCellFactory(dayCellFactory);
 

Значение по умолчанию:

null

Возвращает:

значение свойства dayCellFactory

См. также:

• setDayCellFactory(Callback)
• dayCellFactoryProperty()

public final ObjectProperty<Callback<DatePicker,DateCell>> dayCellFactoryProperty()

 final Callback<DatePicker, DateCell> dayCellFactory = new Callback<DatePicker, DateCell>() {
     public DateCell call(final DatePicker datePicker) {
         return new DateCell() {
             @Override public void updateItem(LocalDate item, boolean empty) {
                 super.updateItem(item, empty);

                 if (MonthDay.from(item).equals(MonthDay.of(9, 25))) {
                     setTooltip(new Tooltip("Happy Birthday!"));
                     setStyle("-fx-background-color: #ff4444;");
                 }
                 if (item.equals(LocalDate.now().plusDays(1))) {
                     // Tomorrow is too soon.
                     setDisable(true);
                 }
             }
         };
     }
 };
 datePicker.setDayCellFactory(dayCellFactory);
 

Значение по умолчанию:

null

Возвращает:

свойство dayCellFactory

См. также:

• getDayCellFactory()
• setDayCellFactory(Callback)

public final ObjectProperty<Chronology> chronologyProperty()

Возвращает:

свойство, представляющее используемый календарь

См. также:

• getChronology()
• setChronology(Chronology)

public final Chronology getChronology()

Описание свойства:

Система календаря, используемая для анализа, отображения и выбора дат в элементе управления DatePicker.

Значение по умолчанию возвращается из вызова Chronology.ofLocale(Locale.getDefault(Locale.Category.FORMAT)). По умолчанию обычно используется IsoChronology, если явно не указано в Locale с помощью расширения календаря Locale. Установка значения в null восстановит календарь по умолчанию.

Возвращает:

значение свойства chronology

См. также:

• setChronology(Chronology)
• chronologyProperty()

public final void setChronology(Chronology value)

Описание свойства:

Система календаря, используемая для парсинга, отображения и выбора дат в элементе управления DatePicker.

Значение по умолчанию возвращается из вызова Chronology.ofLocale(Locale.getDefault(Locale.Category.FORMAT)). Значение по умолчанию обычно IsoChronology, если явно не задано в Locale с помощью расширения календаря Locale. Установка значения в null восстановит хронологию по умолчанию.

Параметры:

value - значение для свойства chronology

См. также:

• getChronology()
• chronologyProperty()

public final BooleanProperty showWeekNumbersProperty()

Возвращает:

true, если всплывающее окно должно отображать столбец с номерами недель

См. также:

• isShowWeekNumbers()
• setShowWeekNumbers(boolean)

public final void setShowWeekNumbers(boolean value)

Описание свойства:

Определяет, должен ли всплывающее окно DatePicker отображать столбец с номерами недель.

Значение по умолчанию указано в ресурсном файле и зависит от страны текущего языка.

Параметры:

value - значение для свойства showWeekNumbers

См. также:

• isShowWeekNumbers()
• showWeekNumbersProperty()

public final boolean isShowWeekNumbers()

Описание свойства:

Определяет, должен ли всплывающее окно DatePicker отображать столбец с номерами недель.

Значение по умолчанию указано в ресурсном файле и зависит от страны текущего языка.

Возвращает:

значение свойства showWeekNumbers

См. также:

• setShowWeekNumbers(boolean)
• showWeekNumbersProperty()

public final ObjectProperty<StringConverter<LocalDate>> converterProperty()

 datePicker.setConverter(new StringConverter<LocalDate>() {
     String pattern = "yyyy-MM-dd";
     DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);

     {
         datePicker.setPromptText(pattern.toLowerCase());
     }

     @Override public String toString(LocalDate date) {
         if (date != null) {
             return dateFormatter.format(date);
         } else {
             return "";
         }
     }

     @Override public LocalDate fromString(String string) {
         if (string != null && !string.isEmpty()) {
             return LocalDate.parse(string, dateFormatter);
         } else {
             return null;
         }
     }
 });
 

   final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
   datePicker.setConverter(new StringConverter<LocalDate>() {
       @Override public String toString(LocalDate value) {
           return defaultConverter.toString(value);
       }

       @Override public LocalDate fromString(String text) {
           try {
               return defaultConverter.fromString(text);
           } catch (DateTimeParseException ex) {
               System.err.println("HelloDatePicker: "+ex.getMessage());
               throw ex;
           }
       }
   });
 

   @Override public LocalDate fromString(String text) {
       if (text != null && !text.isEmpty()) {
           Locale locale = Locale.getDefault(Locale.Category.FORMAT);
           Chronology chrono = datePicker.getChronology();
           String pattern =
               DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                    null, chrono, locale);
           String prePattern = pattern.substring(0, pattern.indexOf("y"));
           String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
           int baseYear = LocalDate.now().getYear() - 99;
           DateTimeFormatter df = new DateTimeFormatterBuilder()
                       .parseLenient()
                       .appendPattern(prePattern)
                       .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                       .appendPattern(postPattern)
                       .toFormatter();
           return LocalDate.from(chrono.date(df.parse(text)));
       } else {
           return null;
       }
   }
 

Возвращает:

свойство, представляющее текущий преобразователь строк LocalDate

См. также:

• getConverter()
• setConverter(StringConverter)

public final void setConverter(StringConverter<LocalDate> value)

Описание свойства:

Преобразует входной текст в объект типа LocalDate и обратно.

Если приложение не задает, класс DatePicker skin установит преобразователь на основе DateTimeFormatter для текущего Locale и chronology. Этот форматер используется для парсинга и отображения текущего значения даты. Установка значения в null восстановит преобразователь по умолчанию.

Пример с явным форматером:

 datePicker.setConverter(new StringConverter<LocalDate>() {
     String pattern = "yyyy-MM-dd";
     DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);

     {
         datePicker.setPromptText(pattern.toLowerCase());
     }

     @Override public String toString(LocalDate date) {
         if (date != null) {
             return dateFormatter.format(date);
         } else {
             return "";
         }
     }

     @Override public LocalDate fromString(String string) {
         if (string != null && !string.isEmpty()) {
             return LocalDate.parse(string, dateFormatter);
         } else {
             return null;
         }
     }
 });
 

Пример, который оборачивает форматер по умолчанию и перехватывает исключения парсинга:

   final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
   datePicker.setConverter(new StringConverter<LocalDate>() {
       @Override public String toString(LocalDate value) {
           return defaultConverter.toString(value);
       }

       @Override public LocalDate fromString(String text) {
           try {
               return defaultConverter.fromString(text);
           } catch (DateTimeParseException ex) {
               System.err.println("HelloDatePicker: "+ex.getMessage());
               throw ex;
           }
       }
   });
 

Базовый год по умолчанию для парсинга входных данных, содержащих только две цифры для года, равен 2000 (см. DateTimeFormatter). Это значение по умолчанию не подходит для ввода даты рождения. Следующий пример изменяет метод fromString() преобразователя, чтобы позволить ввод двухзначного года для дат рождения до 99 лет в прошлом.

   @Override public LocalDate fromString(String text) {
       if (text != null && !text.isEmpty()) {
           Locale locale = Locale.getDefault(Locale.Category.FORMAT);
           Chronology chrono = datePicker.getChronology();
           String pattern =
               DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                    null, chrono, locale);
           String prePattern = pattern.substring(0, pattern.indexOf("y"));
           String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
           int baseYear = LocalDate.now().getYear() - 99;
           DateTimeFormatter df = new DateTimeFormatterBuilder()
                       .parseLenient()
                       .appendPattern(prePattern)
                       .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                       .appendPattern(postPattern)
                       .toFormatter();
           return LocalDate.from(chrono.date(df.parse(text)));
       } else {
           return null;
       }
   }
 

Параметры:

value - значение для свойства converter

См. также:

• getConverter()
• converterProperty()

public final StringConverter<LocalDate> getConverter()

Описание свойства:

Преобразует входной текст в объект типа LocalDate и обратно.

Если приложение не задает, класс DatePicker skin установит преобразователь на основе DateTimeFormatter для текущего Locale и chronology. Этот форматер используется для парсинга и отображения текущего значения даты. Установка значения в null восстановит преобразователь по умолчанию.

Пример с явным форматером:

 datePicker.setConverter(new StringConverter<LocalDate>() {
     String pattern = "yyyy-MM-dd";
     DateTimeFormatter dateFormatter = DateTimeFormatter.ofPattern(pattern);

     {
         datePicker.setPromptText(pattern.toLowerCase());
     }

     @Override public String toString(LocalDate date) {
         if (date != null) {
             return dateFormatter.format(date);
         } else {
             return "";
         }
     }

     @Override public LocalDate fromString(String string) {
         if (string != null && !string.isEmpty()) {
             return LocalDate.parse(string, dateFormatter);
         } else {
             return null;
         }
     }
 });
 

Пример, который оборачивает форматер по умолчанию и перехватывает исключения парсинга:

   final StringConverter<LocalDate> defaultConverter = datePicker.getConverter();
   datePicker.setConverter(new StringConverter<LocalDate>() {
       @Override public String toString(LocalDate value) {
           return defaultConverter.toString(value);
       }

       @Override public LocalDate fromString(String text) {
           try {
               return defaultConverter.fromString(text);
           } catch (DateTimeParseException ex) {
               System.err.println("HelloDatePicker: "+ex.getMessage());
               throw ex;
           }
       }
   });
 

Базовый год по умолчанию для парсинга входных данных, содержащих только две цифры для года, равен 2000 (см. DateTimeFormatter). Это значение по умолчанию не подходит для ввода даты рождения. Следующий пример изменяет метод fromString() преобразователя, чтобы позволить ввод двухзначного года для дат рождения до 99 лет в прошлом.

   @Override public LocalDate fromString(String text) {
       if (text != null && !text.isEmpty()) {
           Locale locale = Locale.getDefault(Locale.Category.FORMAT);
           Chronology chrono = datePicker.getChronology();
           String pattern =
               DateTimeFormatterBuilder.getLocalizedDateTimePattern(FormatStyle.SHORT,
                                                                    null, chrono, locale);
           String prePattern = pattern.substring(0, pattern.indexOf("y"));
           String postPattern = pattern.substring(pattern.lastIndexOf("y")+1);
           int baseYear = LocalDate.now().getYear() - 99;
           DateTimeFormatter df = new DateTimeFormatterBuilder()
                       .parseLenient()
                       .appendPattern(prePattern)
                       .appendValueReduced(ChronoField.YEAR, 2, 2, baseYear)
                       .appendPattern(postPattern)
                       .toFormatter();
           return LocalDate.from(chrono.date(df.parse(text)));
       } else {
           return null;
       }
   }
 

Возвращает:

значение свойства converter

См. также:

• setConverter(StringConverter)
• converterProperty()

public final TextField getEditor()

Описание свойства:

Редактор для DatePicker.

Возвращает:

значение свойства editor

См. также:

• editorProperty()

public final ReadOnlyObjectProperty<TextField> editorProperty()

Возвращает:

свойство editor

См. также:

• getEditor()

public final void commitValue()

Since:

18

public final void cancelEdit()

Since:

18

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Returns:

CssMetaData

public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()

Overrides:

getControlCssMetaData в классе Control

Returns:

неизменяемый список стилизуемых свойств элемента управления CSS

Since:

JavaFX 8.0