パッケージmx.validators
クラスpublic class DateValidator
継承DateValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

DateValidator クラスでは、String、Date または Object に適切な日付が含まれており、指定した形式に適合するかどうかを検証します。 月、日、および年については、1 桁または 2 桁の数字で入力できます。 デフォルトでは、このバリデータは次の形式に適合するかどうかを検証します。

DateValidator クラスで日付を指定する方法は 2 通りあります。

MXML のシンタックスexpandedMXML シンタックスを隠す

The <mx:DateValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <mx:DateValidator 
    allowedFormatChars="/\-. " 
    dayListener="Object specified by daySource"
    dayProperty="No default"
    daySource="No default"
    formatError= "Configuration error: Incorrect formatting string." 
    inputFormat="MM/DD/YYYY" 
    invalidCharError="The date contains invalid characters."
    monthListener="Object specified by monthSource"
    monthProperty="No default"
    monthSource="No default"
    validateAsString="true|false"
    wrongDayError="Enter a valid day for the month."
    wrongLengthError="Type the date in the format inputFormat." 
    wrongMonthError="Enter a month between 1 and 12."
    wrongYearError="Enter a year between 0 and 9999."
    yearListener="Object specified by yearSource"
    yearProperty="No default"
    yearSource="No default"
  />

例を表示


パブリックプロパティ
 プロパティ定義元
  allowedFormatChars : String
月、日、年の各値を区切るために使用できる書式文字のセットを表します。
DateValidator
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  dayListener : IValidatorListener
日付サブフィールドの検証結果をリッスンするコンポーネントを表します。
DateValidator
  dayProperty : String
検証する日付プロパティの名前を表します。
DateValidator
  daySource : Object
日付フィールドの値を含むオブジェクトを表します。
DateValidator
 Inheritedenabled : Boolean
この値を false に設定すると、バリデータによる検証が行えなくなります。
Validator
  formatError : String
inputFormat プロパティが正しい形式でないときのエラーメッセージを表します。
DateValidator
  inputFormat : String
値の検証に使用する日付形式。
DateValidator
  invalidCharError : String
無効な文字が日付に存在するときのエラーメッセージを表します。
DateValidator
 Inheritedlistener : Object
検証のリスナーを指定します。
Validator
  monthListener : IValidatorListener
月サブフィールドの検証結果をリッスンするコンポーネントを表します。
DateValidator
  monthProperty : String
検証する月プロパティの名前を表します。
DateValidator
  monthSource : Object
月フィールドの値を含むオブジェクトを表します。
DateValidator
 Inheritedproperty : String
検証する値を含む source オブジェクトのプロパティの名前を指定するストリングを表します。
Validator
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
 Inheritedrequired : Boolean = true
true の場合、検証エラーの原因となる欠損値または空値を指定します。
Validator
 InheritedrequiredFieldError : String
値が欠損し、required プロパティが true の場合に発生するエラーメッセージです。
Validator
 Inheritedsource : Object
検証するプロパティを含むオブジェクトを指定します。
Validator
 Inheritedtrigger : IEventDispatcher
バリデータをトリガするイベントの生成を行うコンポーネントを指定します。
Validator
 InheritedtriggerEvent : String
検証をトリガするイベントを指定します。
Validator
  validateAsString : Object
値の検証方法を決定します。
DateValidator
  wrongDayError : String
日が無効なときのエラーメッセージを表します。
DateValidator
  wrongLengthError : String
日付の長さが inputFormat プロパティの長さと一致しないときのエラーメッセージを表します。
DateValidator
  wrongMonthError : String
月が無効なときのエラーメッセージを表します。
DateValidator
  wrongYearError : String
年が無効なときのエラーメッセージを表します。
DateValidator
  yearListener : IValidatorListener
年サブフィールドの検証結果をリッスンするコンポーネントを表します。
DateValidator
  yearProperty : String
検証する年プロパティの名前を表します。
DateValidator
  yearSource : Object
年フィールドの値を含むオブジェクトを表します。
DateValidator
プロテクトプロパティ
 プロパティ定義元
 InheritedactualListeners : Array
[読み取り専用] リスナーオブジェクトが存在する場合はリスナーオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedactualTrigger : IEventDispatcher
[読み取り専用] トリガオブジェクトが存在する場合はトリガオブジェクトを含みます。そうでない場合は、ソースオブジェクトを含みます。
Validator
 InheritedresourceManager : IResourceManager
[読み取り専用] アプリケーションのローカライズされたすべてのリソースを管理するオブジェクトへの参照です。
Validator
 InheritedsubFields : Array
validate() メソッドに渡された value オブジェクトに含まれるプロパティ名を含むストリングの配列です。
Validator
パブリックメソッド
 メソッド定義元
  
DateValidator()
コンストラクタです。
DateValidator
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
initialized(document:Object, id:String):void
MXML タグを使用してバリデータを作成したときに、MXML コンパイラによって自動的に呼び出されます。
Validator
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
検証を実行し、リスナーに任意で結果を通知します。
Validator
 Inherited
validateAll(validators:Array):Array
[静的] validators 配列に含まれるすべてのバリデータを呼び出します。
Validator
  
validateDate(validator:DateValidator, value:Object, baseField:String):Array
[静的] カスタム検証関数からバリデータを呼び出す便利なメソッドです。
DateValidator
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
プロテクトメソッド
 メソッド定義元
 Inherited
addListenerHandler():void
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを設定します。
Validator
  
doValidation(value:Object):Array
[override] 日付を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。
DateValidator
 Inherited
getValueFromSource():Object
検証するオブジェクトを返します。
Validator
 Inherited
handleResults(errorResults:Array):ValidationResultEvent
エラー結果の配列から ValidationResultEvent を返します。
Validator
 Inherited
isRealValue(value:Object):Boolean
value が null でない場合、true を返します。
Validator
 Inherited
removeListenerHandler():void
バリデータから送出された valid イベントおよび invalid イベントのすべてのリスナーを切断します。
Validator
 Inherited
resourcesChanged():void
このメソッドは、バリデータが作成されたときと、ResourceManager が "change" イベントを送出してローカライズされたリソースが何らかの点で変更されたことを示すときに再び呼び出されます。
Validator
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
 Inherited
invalid
検証が失敗すると送出されます。Validator
 Inherited
valid
検証が正常に完了すると送出されます。Validator
プロテクト定数
 定数定義元
 InheritedDECIMAL_DIGITS : String = "0123456789"
[静的] 0 から 9 の 10 進数字を含むストリングです。
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[静的] ローマ字アルファベットの大文字と小文字を含む（"A" から "Z"、および "a" から "z"）ストリングです。
Validator
プロパティの詳細
allowedFormatCharsプロパティ
allowedFormatChars:String

月、日、年の各値を区切るために使用できる書式文字のセットを表します。

デフォルト値 : "/\-. ".



実装
    public function get allowedFormatChars():String
    public function set allowedFormatChars(value:String):void
dayListenerプロパティ 
dayListener:IValidatorListener

日付サブフィールドの検証結果をリッスンするコンポーネントを表します。 何も指定されていない場合、daySource プロパティに指定された値が使用されます。



実装
    public function get dayListener():IValidatorListener
    public function set dayListener(value:IValidatorListener):void
dayPropertyプロパティ 
public var dayProperty:String

検証する日付プロパティの名前を表します。 このプロパティはオプションですが、daySource プロパティを指定する場合は、このプロパティも設定する必要があります。

daySourceプロパティ 
daySource:Object

日付フィールドの値を含むオブジェクトを表します。 このプロパティの値を指定する場合は、dayProperty プロパティにも値を指定する必要があります。 source プロパティおよび property プロパティを設定する場合は、このプロパティを使用しないでください。



実装
    public function get daySource():Object
    public function set daySource(value:Object):void
formatErrorプロパティ 
formatError:String

inputFormat プロパティが正しい形式でないときのエラーメッセージを表します。

デフォルト値 : "設定エラー : ストリングのフォーマットが正しくありません。".



実装
    public function get formatError():String
    public function set formatError(value:String):void
inputFormatプロパティ 
inputFormat:String

値の検証に使用する日付形式。 ここで、"MM" は月、"DD" は日、"YYYY" は年です。 このストリングは大文字と小文字が区別されます。

デフォルト値 : MM/DD/YYYY.



実装
    public function get inputFormat():String
    public function set inputFormat(value:String):void
invalidCharErrorプロパティ 
invalidCharError:String

無効な文字が日付に存在するときのエラーメッセージを表します。

デフォルト値 : "日付に無効な文字が含まれています。".



実装
    public function get invalidCharError():String
    public function set invalidCharError(value:String):void
monthListenerプロパティ 
monthListener:IValidatorListener

月サブフィールドの検証結果をリッスンするコンポーネントを表します。 何も指定されていない場合、monthSource プロパティに指定された値が使用されます。



実装
    public function get monthListener():IValidatorListener
    public function set monthListener(value:IValidatorListener):void
monthPropertyプロパティ 
public var monthProperty:String

検証する月プロパティの名前を表します。 このプロパティはオプションですが、monthSource プロパティを指定する場合は、このプロパティも設定する必要があります。

monthSourceプロパティ 
monthSource:Object

月フィールドの値を含むオブジェクトを表します。 このプロパティの値を指定する場合は、monthProperty プロパティにも値を指定する必要があります。 source プロパティおよび property プロパティを設定する場合は、このプロパティを使用しないでください。



実装
    public function get monthSource():Object
    public function set monthSource(value:Object):void
validateAsStringプロパティ 
validateAsString:Object

値の検証方法を決定します。 true に設定すると、値に month、day または year プロパティがない限り、バリデータは値をストリングとして評価します。false の場合、バリデータはその値を Date オブジェクトとして評価します。

デフォルト値 : true.



実装
    public function get validateAsString():Object
    public function set validateAsString(value:Object):void
wrongDayErrorプロパティ 
wrongDayError:String

日が無効なときのエラーメッセージを表します。

デフォルト値 : 「月の有効な日付を入力してください。」.



実装
    public function get wrongDayError():String
    public function set wrongDayError(value:String):void
wrongLengthErrorプロパティ 
wrongLengthError:String

日付の長さが inputFormat プロパティの長さと一致しないときのエラーメッセージを表します。

デフォルト値 : 「日付を inputFormat という形式で入力します。」.



実装
    public function get wrongLengthError():String
    public function set wrongLengthError(value:String):void
wrongMonthErrorプロパティ 
wrongMonthError:String

月が無効なときのエラーメッセージを表します。

デフォルト値 : 「1 ～ 12 の範囲で月を入力してください。」.



実装
    public function get wrongMonthError():String
    public function set wrongMonthError(value:String):void
wrongYearErrorプロパティ 
wrongYearError:String

年が無効なときのエラーメッセージを表します。

デフォルト値 : 「0 ～ 9999 の範囲で年を入力してください。」.



実装
    public function get wrongYearError():String
    public function set wrongYearError(value:String):void
yearListenerプロパティ 
yearListener:IValidatorListener

年サブフィールドの検証結果をリッスンするコンポーネントを表します。 何も指定されていない場合、yearSource プロパティに指定された値が使用されます。



実装
    public function get yearListener():IValidatorListener
    public function set yearListener(value:IValidatorListener):void
yearPropertyプロパティ 
public var yearProperty:String

検証する年プロパティの名前を表します。 このプロパティはオプションですが、yearSource プロパティを指定する場合は、このプロパティも設定する必要があります。

yearSourceプロパティ 
yearSource:Object

年フィールドの値を含むオブジェクトを表します。 このプロパティの値を指定する場合は、yearProperty プロパティにも値を指定する必要があります。 source プロパティおよび property プロパティを設定する場合は、このプロパティを使用しないでください。



実装
    public function get yearSource():Object
    public function set yearSource(value:Object):void
コンストラクタの詳細
DateValidator()コンストラクタ
public function DateValidator()

コンストラクタです。

メソッドの詳細
doValidation()メソッド
override protected function doValidation(value:Object):Array

日付を検証する上で基本クラスの doValidation() メソッドをオーバーライドします。

このメソッドはユーザーが直接呼び出すものではなく、妥当性を検証する際に Flex から呼び出されます。 Validator クラスをカスタムで作成する場合は、このメソッドを実装する必要があります。

パラメータ

value:Object — 検証するストリングまたはオブジェクトのいずれかとなります。

戻り値
Array — ValidationResult オブジェクトの配列です。このオブジェクトは、検証が行われるフィールドごとに 1 つ含まれます。
validateDate()メソッド 
public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array

カスタム検証関数からバリデータを呼び出す便利なメソッドです。 他の標準 Flex バリデータにもそれぞれ同様の便利なメソッドがあります。

パラメータ

validator:DateValidator — DateValidator インスタンスを表します。
 
value:Object — 検証するフィールドを表します。
 
baseField:String — value パラメータで指定したサブフィールドのテキストの型を表します。 例えば、value パラメータで value.date を指定する場合、baseField の値は "date" です。

戻り値
Array — ValidationResult オブジェクトの配列です。このオブジェクトは、検証が行われるフィールドごとに 1 つ含まれます。

関連項目

mx.validators.ValidationResult
例 例の使用法
DateValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the DateValidator. -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        import mx.controls.Alert;
    </mx:Script>

    <mx:Model id="CheckModel">
        <dateInfo>
            <DOB>{dob.text}</DOB>
        </dateInfo>
    </mx:Model>

    <mx:DateValidator source="{dob}" property="text" allowedFormatChars="/" 
        trigger="{myButton}" triggerEvent="click" 
        valid="Alert.show('Validation Succeeded!');"/>

    <mx:Panel title="DateValidator Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Form>
            <mx:FormItem label="Enter date of birth (mm/dd/yyyy): ">
                <mx:TextInput id="dob" width="100%"/>
            </mx:FormItem>

            <mx:FormItem >
                <mx:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>

    </mx:Panel>
</mx:Application>



© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/validators/DateValidator.html