当您在项目渲染器或项目编辑器中使用某个组件时，可借助 data 属性向该组件传递值。您通常使用数据绑定将 data 属性的字段绑定到此组件的某个属性。

当您使用此控件作为嵌入式项目渲染器或嵌入式项目编辑器时，Flex 会自动将项目的当前值写入此控件的 selectedDate 属性。

默认值为 null.

此属性可用作数据绑定的源。修改此属性后，将调度 dataChange 事件。

另请参见

DateChooser 控件中的工作日名称。设置此属性将更改 DateChooser 控件的日期标签。星期日为第一天（在索引为 0 处）。一周中其余的天按照正常的顺序命名。

默认值为 [ "S", "M", "T", "W", "T", "F", "S" ].

此属性可用作数据绑定的源。修改此属性后，将调度 dayNamesChanged 事件。

一周中禁用的日期。每月中除指定日期外，所有日期都被禁用。此属性可立即更改 DateChooser 控件的用户界面。此 Array 中的元素可使用介于 0（星期日）和 6（星期六）之间的值。例如，如果设置值 [ 0, 6 ]，将禁用星期日和星期六。

默认值为 [].

此属性可用作数据绑定的源。修改此属性后，将调度 disabledDaysChanged 事件。

禁用一天或多天。

此属性接受对象 Array 作为参数。此 Array 中的所有对象都是 Date 对象，用于指定要禁用的各个日期；也可以是包含 rangeStart 和（或）rangeEnd 属性的对象，它们的每个值都是 Date 对象。这些属性的值描述了日期范围的边界。如果忽略其中任一属性，则认为在该方向上无范围限制。如果仅指定 rangeStart，则将禁用指定日期之后的所有日期（包括 rangeStart 日期）。如果仅指定 rangeEnd，则将禁用指定日期之前的所有日期（包括 rangeEnd 日期）。要禁用某一日期，请使用一个 Date 对象指定 Array 中的某个日期。时间值（如果存在）将以 Date 对象为零值，依次递增。

以下示例将禁用下列日期：2006 年 1 月 11 日，从 2006 年 1 月 23 至同年 2 月 10 日，以及 2006 年 3 月 1 日及后续所有日期。

disabledRanges="{[new Date(2006,0,11), {rangeStart:
      new Date(2006,0,23), rangeEnd: new Date(2006,1,10)},
      {rangeStart: new Date(2006,2,1)}]}"

如果 displayedMonth 和 displayedYear 属性中包含禁用的日期，则设置此属性将立即更改 DateChooser 控件的外观。

默认值为 [].

此属性可用作数据绑定的源。修改此属性后，将调度 disabledRangesChanged 事件。

将 displayedMonth 属性与 displayedYear 属性一起使用可指定在 DateChooser 控件中显示的月份。月份从零开始，因此一月份为 0，十二月份为 11。设置此属性将立即更改 DateChooser 控件的外观。默认值为当前日期的月份。

默认值为当前月份。

此属性可用作数据绑定的源。修改此属性后，将调度 displayedMonthChanged 事件。

将 displayedYear 属性与 displayedMonth 属性一起使用可确定在 DateChooser 控件中显示的年份。设置此属性将立即更改 DateChooser 控件的外观。

默认值为当前年份。

此属性可用作数据绑定的源。修改此属性后，将调度 displayedYearChanged 事件。

包含对 DateChooser 控件（包含在 DateField 控件中）的引用。只要所用的类扩展 DateChooser，即可使用 dropdownFactory 设置所用的类。

IFactory，可创建 DateChooser 派生的实例以用作日期选择器。默认值是 DateChooser 的一个 IFactory。

此属性可用作数据绑定的源。修改此属性后，将调度 dropdownFactoryChanged 事件。

DateChooser 控件第一列中显示的一周中的日期（0－6，其中 0 是 dayNames Array 的第一个元素）设置此属性将更改日期列的顺序。

默认值为 0 (Sunday).

文本字段中所显示日期的格式。此属性包含 "MM"、"DD"、"YY"、"YYYY"、分隔符和标点符号的任意组合。

默认值为 "MM/DD/YYYY".

用于设置 DateField 控件的文本字段中日期显示格式的函数。如果未指定函数，则使用默认格式。

该函数采用 Date 对象作为参数，并以要显示的格式返回一个字符串，如下例所示：

public function formatDate(currentDate:Date):String {
          ...
          return dateString;
      }

如果允许用户在 DateField 控件的文本字段中输入日期，并且使用 labelFunction 属性定义格式化函数，则应为 parseFunction 属性指定一个函数将输入文本字符串转换为 Date 对象以供 DateField 控件使用，或者将 parseFunction 属性设置为 null。

默认值为 null.

此属性可用作数据绑定的源。修改此属性后，将调度 labelFunctionChanged 事件。

另请参见

使用组件作为嵌入式项目渲染器或嵌入式项目编辑器时，Flex 将使用 List 控件中的相应数据初始化该组件的 listData 属性。然后，组件可使用 listData 属性初始化嵌入式项目渲染器或嵌入式项目编辑器的 data 属性。

您无需在 MXML 或 ActionScript 中设置此属性；将组件用作嵌入式项目渲染器或嵌入式项目编辑器时，Flex 会对其进行设置。

默认值为 null.

此属性可用作数据绑定的源。修改此属性后，将调度 dataChange 事件。

另请参见

控件中可选的最后一个年份。

默认值为 2100.

控件中可选的第一个年份。

默认值为 1900.

控件顶部显示的月份名称。将 monthSymbol 属性追加到由 monthNames 属性指定的值末尾，该属性这在语言（如日语）中很有用。

默认值为 [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ].

此属性可用作数据绑定的源。修改此属性后，将调度 monthNamesChanged 事件。

将此属性追加到由 monthNames 属性指定的值末尾以便定义在控件顶部显示的月份名称。有些语言（如日语）会在月份名称后使用额外的符号。

默认值为 "".

此属性可用作数据绑定的源。修改此属性后，将调度 monthSymbolChanged 事件。

用于解析在 DateField 控件的文本字段区域中以文本格式输入的日期，并向此控件返回 Date 对象的函数。如果未指定函数，则 Flex 将使用默认函数。如果设置了 parseFunction 属性，则通常应执行为 labelFunction 属性指定的函数的反函数。

此函数采用两个参数，并向 DateField 控件返回一个数据对象，如下例所示：

public function parseDate(valueString:String, inputFormat:String):Date {
          ...
          return newDate
      }

其中，valueString 参数包含用户在文本字段中输入的文本字符串，而 inputFormat 参数包含字符串的格式。例如，如果只允许用户使用两个字符输入文本字符串表示月份、日期和年份，然后将“MM/DD/YY”传递给 inputFormat 参数。

此属性可用作数据绑定的源。修改此属性后，将调度 parseFunctionChanged 事件。

另请参见

日期范围，可从中选择日期。例如，可以选择 04-12-2006 和 04-12-2007 之间的日期，而超出此范围的日期将被禁用。

此属性接受 Object 作为参数。该 Object 包含 Date 类型的两个属性：rangeStart 和 rangeEnd。如果仅指定了 rangeStart，则在此指定日期之后的所有日期都可用。如果仅指定了 rangeEnd，则在此指定日期之前的所有日期都可用。要仅在 DateChooser 控件中使用一个日期，可以直接传递一个 Date 对象。时间值（如果存在）将以 Date 对象为零值，依次递增。

以下示例仅启用 2006 年 1 月 1 日到 2006 年 6 月 30 日的范围。1 月之前和 6 月之后的月份不会出现在 DateChooser 中。

selectableRange="{{rangeStart : new Date(2006,0,1),
      rangeEnd : new Date(2006,5,30)}}"

默认值为 null.

此属性可用作数据绑定的源。修改此属性后，将调度 selectableRangeChanged 事件。

DateChooser 控件中选定的日期。接受 Date 对象作为参数。如果传入的 Date 对象包含任何时间值，则它们将被清零。

选择控件中当前选定的日期，对其取消选中，将 selectedDate 属性设置为 null，然后调度 change 事件。

默认值为 null.

此属性可用作数据绑定的源。修改此属性后，将调度 valueCommit 事件。

如果为 true，则指定在 DateChooser 控件中加亮显示今天。设置此属性将立即更改 DateChooser 控件的外观。

默认值为 true.

此属性可用作数据绑定的源。修改此属性后，将调度 showTodayChanged 事件。

启用年份导航。如果为 true，则显示的年份右侧会出现向上和向下按钮。您可以使用这些按钮更改当前年份。在采用年份显示在月份之前的日期格式的区域设置中，这些按钮将显示在年份的左侧。

默认值为 false.

此属性可用作数据绑定的源。修改此属性后，将调度 yearNavigationEnabledChanged 事件。

此属性将追加到在控件顶部显示的年份末尾。有些语言（如日语）会在年份后添加符号。

默认值为 "".

此属性可用作数据绑定的源。修改此属性后，将调度 yearSymbolChanged 事件。

构造函数。

关闭 DateChooser 控件。

根据 outputFormat 参数，将 Date 格式化为 String。outputFormat 参数包含可在其中设置 value 字符串格式的模式。此参数可包含 "M","D","Y"、分隔符以及标点符号。

参数

var todaysDate:String = DateField.dateToString(new Date(), "MM/DD/YYYY");

打开 DateChooser 控件。

解析包含日期的字符串对象，并返回一个与此 String 对应的 Date 对象。inputFormat 参数包含可在其中设置 valueString String 格式的模式。此参数可包含 "M","D","Y"、分隔符以及标点符号。

此函数不检查 Date 对象的有效性。如果日期、月份或年份的值为 NaN，则此方法将返回 null。

例如：

var dob:Date = DateField.stringToDate("06/30/2005", "MM/DD/YYYY");

参数

当选择或更改日期，且 DateChooser 控件关闭时调度。

事件对象的属性有下列值：

当选择日期或用户在下拉列表外部单击时调度。

事件对象的属性有下列值：

当 data 属性更改时进行调度。

当您使用组件作为项目渲染器时，data 属性将包含要显示的数据。您可以侦听此事件，并在 data 属性更改时更新组件。

事件对象的属性有下列值：

当用户选择字段打开下拉列表时调度。

事件对象的属性有下列值：

当月份由于用户交互操作而更改时调度。

事件对象的属性有下列值：