DateField  - AS3 Flex

アイテムレンダラーまたはアイテムエディターで data プロパティを使用すると、コンポーネントに値を渡すことができます。 通常、データバインディングを使用して、data プロパティのフィールドをこのコンポーネントのプロパティにバインドします。

ドロップインアイテムレンダラーまたはドロップインアイテムエディターとしてコントロールを使用すると、アイテムの現在の値が、このコントロールの selectedDate プロパティに自動的に書き込まれます。

デフォルト値： null。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataChange イベントが送出されます。

関連する API エレメント

DateChooser コントロール用の曜日名です。 このプロパティを設定すると、DateChooser コントロールの日付ラベルが変更されます。日曜日を週の最初の曜日（インデックス 0）とします。以降の曜日が通常の順序で続きます。

デフォルト値： [ "S", "M", "T", "W", "T", "F", "S" ]。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dayNamesChanged イベントが送出されます。

無効にする曜日です。 指定した曜日に該当するその月のすべての日付が無効になります。このプロパティの設定は、DateChooser コントロールのユーザーインターフェイスに即座に反映されます。この配列のエレメントは 0（日曜日）から 6（土曜日）の範囲の値です。 例えば、[0, 6] という値を設定すると、日曜日と土曜日が無効になります。

デフォルト値： []。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 disabledDaysChanged イベントが送出されます。

1 日または複数の日を無効にします。

このプロパティは、パラメーターとしてオブジェクトの配列を受け入れます。 この配列にあるオブジェクトはそれぞれ Date オブジェクトです。無効にする 1 日を指定するか、あるいは、Date オブジェクトの値を持つ rangeStart プロパティおよび rangeEnd プロパティのいずれか一方または両方を含むオブジェクトを指定します。 これらのプロパティの値は、日付範囲の先頭と末尾を示します。 いずれかのプロパティを省略した場合、そちら側の境界には制限がなくなります。 rangeStart のみを指定した場合は、rangeStart の日付を含めて、指定した日付より後の日付がすべて無効になります。 rangeEnd のみを指定した場合は、rangeEnd の日付を含めて、指定した日付より前の日付がすべて無効になります。 1 日のみを無効にするには、配列内の日付を指定する単一の Date オブジェクトを使用します。 時間の値が存在する場合は、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)}]}"

このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます（無効にされた日付が displayedMonth および displayedYear プロパティに含まれる場合）。

デフォルト値： []。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 disabledRangesChanged イベントが送出されます。

displayedYear プロパティは、displayedMonth プロパティと共に、DateChooser コントロールに表示される月を指定するために使用します。 月を表す数字は 0 から始まるので、1 月は 0 で 12 月は 11 です。 このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます。 デフォルト値は今日の日付の月番号です。

デフォルト値は現在の月です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 displayedMonthChanged イベントが送出されます。

displayedMonth プロパティは、displayedYear プロパティと共に、DateChooser コントロールに表示される年を決定するために使用します。 このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます。

デフォルト値は現在の年です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 displayedYearChanged イベントが送出されます。

DateField コントロールに含まれる DateChooser コントロールへの参照が含まれます。 使用されるクラスは dropdownFactory で設定できます。これは、DateChooser を拡張する限り可能です。

日付選択用カレンダーとして使用するために、DateChooser から派生したインスタンスを生成する IFactory です。デフォルト値は DateChooser の IFactory です。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dropdownFactoryChanged イベントが送出されます。

DateChooser コントロールの最初の列に表示する曜日です（0 ～ 6。0 は dayNames 配列の最初のエレメント）。 このプロパティを設定すると、日付列の順序が変更されます。

デフォルト値： 0 (Sunday)。

テキストフィールドに表示される日付の形式です。 このプロパティは、"MM"、"DD"、"YY"、"YYYY"、区切り文字および句読点を組み合わせて指定できます。

デフォルト値： "MM/DD/YYYY"。

DateField コントロールのテキストフィールドに表示される日付に、書式設定する場合に使用する関数です。 関数を指定しない場合は、デフォルトの形式が使用されます。

この関数は引数として Date オブジェクトを取り、次の例に示すように表示する書式のストリングを返します。

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

DateField コントロールのテキストフィールドにユーザーが日付を入力することを許可し、labelFunction プロパティを使用してフォーマット関数を定義する場合、入力テキストストリングを DateField コントロールで使用するための Date オブジェクトに変換する関数を parseFunction プロパティに指定するか、parseFunction プロパティを null に設定する必要があります。

デフォルト値： null。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 labelFunctionChanged イベントが送出されます。

関連する API エレメント

ドロップインアイテムレンダラーまたはドロップインアイテムエディターとしてこのコンポーネントを使用すると、その listData プロパティが、List コントロールの該当するデータで初期化されます。 その後、コンポーネントでこの listData プロパティを使用して、ドロップインアイテムレンダラーまたはドロップインアイテムエディターの data プロパティを初期化できます。

MXML および ActionScript でこのプロパティを設定することはありません。このコンポーネントがドロップインアイテムレンダラーまたはドロップインアイテムエディターとして使用されるときに、Flex でプロパティが設定されます。

デフォルト値： null。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 dataChange イベントが送出されます。

関連する API エレメント

コントロール内で選択可能な最後の年です。

デフォルト値： 2100。

コントロール内で選択可能な最初の年です。

デフォルト値： 1900。

コントロールの最上部に表示される月の名前です。 monthSymbol プロパティは、monthNames プロパティによって指定された値の後ろに追加されます。これは、日本語などの言語で役に立ちます。

デフォルト値： [ "January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December" ]。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 monthNamesChanged イベントが送出されます。

このプロパティは、monthNames プロパティによって定義された値の後ろに追加され、コントロールの最上部に表示される月の名前を定義します。 日本語などの一部の言語では、月の名前の後ろに文字を追加します。

デフォルト値： ""。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 monthSymbolChanged イベントが送出されます。

DateField コントロールのテキストフィールド領域にテキストとして入力される日付を解析し、その DateField コントロールに Date オブジェクトを返す関数です。関数を指定しない場合、デフォルト関数が使用されます。 parseFunction プロパティが設定されている場合、通常、labelFunction プロパティに指定されている関数の反転を実行する必要があります。

この関数は引数として 2 つの引数を取り、次の例に示すように DateField コントロールに Date オブジェクトを返します。

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

ここで、valueString 引数は、ユーザーがテキストフィールドに入力するテキストストリングを含み、inputFormat 引数はストリング形式を含みます。 例えば、月、日、年の 2 文字を使用してテキストストリングを入力できる場合は、inputFormat 引数に「MM/DD/YY」を渡します。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 parseFunctionChanged イベントが送出されます。

関連する API エレメント

選択可能な日付の範囲です。 例えば、2006 年 12 月 04 日から 2007 年 12 月 04 日までの日付を選択可能にし、この範囲外の日付を無効にします。

このプロパティは、パラメーターとして 1 つのオブジェクトを受け入れます。 このオブジェクトには、rangeStart と rangeEnd の 2 つの Date 型プロパティが含まれます。 rangeStart のみを指定した場合は、指定した日付以降の日付がすべて有効になります。 rangeEnd のみを指定した場合は、指定した日付より前の日付がすべて有効になります。 DateChooser コントロールで 1 つの日付のみを有効にするには、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 コントロールで選択されている日付です。 パラメーターとして 1 つの Date オブジェクトを受け入れます。 受け取った Date オブジェクトに時間値がある場合、それらはゼロに設定されます。

Ctrl キーを押しながら現在選択されている日付を選択すると、その日付の選択が解除され、selectedDate プロパティが null に設定されて、change イベントが送出されます。

デフォルト値： null。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 selectedDateChanged イベントが送出されます。

true の場合、DateChooser コントロールで今日の日付が強調表示されます。 このプロパティを設定すると、DateChooser コントロールの外観が直ちに変更されます。

デフォルト値： true。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 showTodayChanged イベントが送出されます。

年ナビゲーションを有効にします。 true である場合、表示された年の右側に上下のボタンが表示されます。 これらのボタンを使用して、今年を変更できます。 これらのボタンは、年を月の前に置く日付形式を使用するロケールでは、年の左側に表示されます。

デフォルト値： false。

このプロパティはデータバインディングのソースとして使用できます。 このプロパティを変更すると、 yearNavigationEnabledChanged イベントが送出されます。