ASDoc

mx.validators
DateValidator クラス

DateValidator クラス
mx.validators.Validator の拡張

ストリングまたはオブジェクトが、正しい日付であり指定されたフォーマットに一致することを検証します。

MXML シンタックス

<mx:DateValidator> タグは、親クラスのプロパティと、次のプロパティを受け取ります。

 <mx:DateValidator
   allowedFormatChars="/\-." 
   inputFormat="mm/dd/yyyy"
   formatError= "Configuration error:Incorrect formatting string."
   invalidCharError="Invalid characters in your date."
   iinvalidFormatCharsError="The allowedFormatChars parameter is invalid.It cannot contain any digits."
   wrongDayError=""Please enter a valid day for the month."
   wrongLengthError="Please type the date in the format inputFormat."
   wrongMonthError="Please enter a month between 1 and 12."
   wrongYearError="Please enter a year between 0 and 9999." 
 />

例を参照するにはここをクリックしてください

メソッド
	`doValidation( value:Object) : Void` 値が有効な日付であることを検証します。
`static`	`validateDate( validator:mx.validators.Validator, value:Object, paramObj:Object, baseField:String) : Boolean` <mx:Validator> タグを使用する場合に、カスタム検証関数からバリデータを呼び出す便利なメソッドです。

mx.validators.Validator クラスから継承されるメソッド

disable doValidation enable hasErrors isStructureValid isValid validateRequired validationError

プロパティ
	`allowedFormatChars:String` 月、日、年の各値を区切るために使用できる書式文字のセットを表します。
	`formatError:String` inputFormat パラメータが正しい形式でないときのエラーメッセージを表します。
	`inputFormat:String` 値を検証する際の対象となる日付フォーマットを表します。
	`invalidCharError:String` 無効な文字が日付に存在するときのエラーメッセージを表します。
	`invalidFormatCharsError:String` allowedFormatChars パラメータが無効なときのエラーメッセージを表します。
	`validateAsString:Boolean` ブール値を表します。デフォルトは `true` です。
	`wrongDayError:String` 日にちが無効なときのエラーメッセージを表します。
	`wrongLengthError:String` 日付の長さが inputFormat の長さと一致しないときのエラーメッセージを表します。
	`wrongMonthError:String` 月が無効なときのエラーメッセージを表します。
	`wrongYearError:String` 年が無効なときのエラーメッセージを表します。

mx.validators.Validator クラスから継承されるプロパティ

field listener required requiredFieldError validate

メソッドの詳細

doValidation

doValidation( value:Object)
										
													 :  Void

値が有効な日付であることを検証します。value パラメータには、次の属性を含むストリングまたはオブジェクトのいずれかを指定できます。

day - 月内の日付を指定する数値を表します。
month - 年内の月を指定する数値を表します。
year - 年を指定する数値を表します。

パラメータ
value:Object - String または Object のいずれかになります。

validateDate

static  validateDate( validator:mx.validators.Validator, value:Object, paramObj:Object, baseField:String)
										
													 :  Boolean

<mx:Validator> タグを使用する場合に、カスタム検証関数からバリデータを呼び出す便利なメソッドです。他の標準バリデータにもそれぞれ同様の便利なメソッドがあります。

パラメータ
    validator:mx.validators.Validator - Validator インスタンスです。
    value:Object - value.subfield。タグの field プロパティで指定された値のサブフィールドを subfield として指定します。
    paramObj:Object - パラメータ情報 (エラーメッセージ、最小値と最大値など) を含んだオブジェクトを指定します。このパラメータはオプションですが、baseField を指定する場合には、null を指定します。
    baseField:String - value パラメータで指定した subfield のテキスト表現を指定します。たとえば、value パラメータで value.date を指定する場合、baseField の値は "date" です。

プロパティの詳細

allowedFormatChars

allowedFormatChars:String

月、日、年の各値を区切るために使用できる書式文字のセットを表します。デフォルト値は "/\-. " です。 ".

formatError

formatError:String

inputFormat パラメータが正しい形式でないときのエラーメッセージを表します。デフォルト値は "Configuration error: Incorrect formatting string." です。

inputFormat

inputFormat:String

値を検証する際の対象となる日付形式を表します。デフォルト値は "mm/dd/yyyy" です。ここで、"mm" は月、"dd" は日、"yyyy" は年です。このストリングは大文字と小文字が区別されます。

invalidCharError

invalidCharError:String

無効な文字が日付に存在するときのエラーメッセージを表します。デフォルト値は "Invalid characters in your date." です。

invalidFormatCharsError

invalidFormatCharsError:String

allowedFormatChars パラメータが無効なときのエラーメッセージを表します。デフォルト値は、"The allowedFormatChars parameter is invalid.It cannot contain any digits." です。

validateAsString

validateAsString:Boolean

ブール値を表します。デフォルトは true です。true に設定した場合、value は、month、day、または year プロパティを持っていない限り、ストリングとして評価されます。通常は、このパラメータを設定する必要はありません。

wrongDayError

wrongDayError:String

日にちが無効なときのエラーメッセージを表します。デフォルト値は "Please enter a valid day for the month." です。

wrongLengthError

wrongLengthError:String

日付の長さが inputFormat の長さと一致しないときのエラーメッセージを表します。デフォルト値は "Please type the date in the format inputFormat." です。

wrongMonthError

wrongMonthError:String

月が無効なときのエラーメッセージを表します。デフォルト値は "Please enter a month between 1 and 12." です。

wrongYearError

wrongYearError:String

年が無効なときのエラーメッセージを表します。デフォルト値は "Please enter a year between 0 and 9999." です。

例

DateValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Date バリデータの使用方法を示す簡単な例 -->
<mx:Application xmlns:mx="http://www.macromedia.com/2003/mxml" backgroundColor="#FFFFFF">

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

<mx:Panel title="Date Validator Panel" backgroundColor="#0C8BF3">

<mx:VBox>

<mx:Form>

<mx:FormItem label="Date of birth (mm/dd/yyyy):" color="#FFFFFF">
<mx:TextInput id="dob" width="200" color="#000000"/>
</mx:FormItem>

</mx:Form>

<mx:Label text="*press enter to check validation." color="#FFCCCC"/>

</mx:VBox>

</mx:Panel>

<mx:DateValidator field="CheckModel.DOB" allowedFormatChars="/"/>

</mx:Application>

mx.validators DateValidator クラス