Класс DatePicker

dayCellFactory

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()

chronology

public final ObjectProperty<Chronology> chronologyProperty

См. также:

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

showWeekNumbers

public final BooleanProperty showWeekNumbersProperty

См. также:

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

converter

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()

editor

public final ReadOnlyObjectProperty<TextField> editorProperty

См. также:

• getEditor()
• editorProperty()

DatePicker

public DatePicker()

DatePicker

public DatePicker(LocalDate localDate)

Параметры:

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

setDayCellFactory

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()

getDayCellFactory

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()

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)

chronologyProperty

public final ObjectProperty<Chronology> chronologyProperty()

Возвращает:

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

См. также:

• getChronology()
• setChronology(Chronology)

getChronology

public final Chronology getChronology()

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

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

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

Возвращает:

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

См. также:

• setChronology(Chronology)
• chronologyProperty()

setChronology

public final void setChronology(Chronology value)

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

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

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

Параметры:

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

См. также:

• getChronology()
• chronologyProperty()

showWeekNumbersProperty

public final BooleanProperty showWeekNumbersProperty()

Возвращает:

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

См. также:

• isShowWeekNumbers()
• setShowWeekNumbers(boolean)

setShowWeekNumbers

public final void setShowWeekNumbers(boolean value)

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

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

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

Параметры:

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

См. также:

• isShowWeekNumbers()
• showWeekNumbersProperty()

isShowWeekNumbers

public final boolean isShowWeekNumbers()

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

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

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

Возвращает:

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

См. также:

• setShowWeekNumbers(boolean)
• showWeekNumbersProperty()

converterProperty

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)

setConverter

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()

getConverter

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()

getEditor

public final TextField getEditor()

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

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

Возвращает:

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

См. также:

• editorProperty()

editorProperty

public final ReadOnlyObjectProperty<TextField> editorProperty()

Возвращает:

свойство editor

См. также:

• getEditor()

commitValue

public final void commitValue()

Since:

18

cancelEdit

public final void cancelEdit()

Since:

18

getClassCssMetaData

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

Возвращает:

CssMetaData

getControlCssMetaData

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

Переопределяет:

getControlCssMetaData в классе Control

Возвращает:

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

С:

JavaFX 8.0