DateValidator

패키지	mx.validators
클래스	public class DateValidator
상속	DateValidator Validator EventDispatcher Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

The DateValidator class validates that a String, Date, or Object contains a proper date and matches a specified format. Users can enter a single digit or two digits for month, day, and year. By default, the validator ensures the following formats:

The month is between 1 and 12 (or 0-11 for Date objects)
The day is between 1 and 31
The year is a number

You can specify the date in the DateValidator class in two ways:

Single String containing the date - Use the source and property properties to specify the String. The String can contain digits and the formatting characters specified by the allowedFormatChars property, which include the "/\-. " characters. By default, the input format of the date in a String field is "MM/DD/YYYY" where "MM" is the month, "DD" is the day, and "YYYY" is the year. You can use the inputFormat property to specify a different format.
Date object.
Object or multiple fields containing the day, month, and year. Use all of the following properties to specify the day, month, and year inputs: daySource, dayProperty, monthSource, monthProperty, yearSource, and yearProperty.

MXML 구문

MXML 구문 숨기기

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 The set of formatting characters allowed for separating the month, day, and year values.	DateValidator
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		dayListener : IValidatorListener The component that listens for the validation result for the day subfield.	DateValidator
		dayProperty : String Name of the day property to validate.	DateValidator
		daySource : Object Object that contains the value of the day field.	DateValidator
		enabled : Boolean Setting this value to false will stop the validator from performing validation.	Validator
		formatError : String Error message when the inputFormat property is not in the correct format.	DateValidator
		inputFormat : String The date format to validate the value against.	DateValidator
		invalidCharError : String Error message when there are invalid characters in the date.	DateValidator
		listener : Object Specifies the validation listener.	Validator
		monthListener : IValidatorListener The component that listens for the validation result for the month subfield.	DateValidator
		monthProperty : String Name of the month property to validate.	DateValidator
		monthSource : Object Object that contains the value of the month field.	DateValidator
		property : String A String specifying the name of the property of the source object that contains the value to validate.	Validator
		required : Boolean = true If true, specifies that a missing or empty value causes a validation error.	Validator
		requiredFieldError : String Error message when a value is missing and the required property is true.	Validator
		source : Object Specifies the object containing the property to validate.	Validator
		trigger : IEventDispatcher Specifies the component generating the event that triggers the validator.	Validator
		triggerEvent : String Specifies the event that triggers the validation.	Validator
		validateAsString : Object Determines how to validate the value.	DateValidator
		wrongDayError : String Error message when the day is invalid.	DateValidator
		wrongLengthError : String Error message when the length of the date doesn't match that of the inputFormat property.	DateValidator
		wrongMonthError : String Error message when the month is invalid.	DateValidator
		wrongYearError : String Error message when the year is invalid.	DateValidator
		yearListener : IValidatorListener The component that listens for the validation result for the year subfield.	DateValidator
		yearProperty : String Name of the year property to validate.	DateValidator
		yearSource : Object Object that contains the value of the year field.	DateValidator

보호 속성

상속되는 보호 속성 숨기기

상속되는 보호 속성 표시

	속성		정의 주체
		actualListeners : Array [읽기 전용] Contains an Array of listener objects, if any, or the source object.	Validator
		actualTrigger : IEventDispatcher [읽기 전용] Contains the trigger object, if any, or the source object.	Validator
		resourceManager : IResourceManager [읽기 전용] A reference to the object which manages all of the application's localized resources.	Validator
		subFields : Array An Array of Strings containing the names for the properties contained in the value Object passed to the validate() method.	Validator

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		DateValidator() Constructor.	DateValidator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		initialized(document:Object, id:String):void Called automatically by the MXML compiler when the Validator is created using an MXML tag.	Validator
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Performs validation and optionally notifies the listeners of the result.	Validator
		validateAll(validators:Array):Array [정적] Invokes all the validators in the validators Array.	Validator
		validateDate(validator:DateValidator, value:Object, baseField:String):Array [정적] Convenience method for calling a validator from within a custom validation function.	DateValidator
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

보호 메서드

상속되는 보호 메서드 숨기기

상속되는 보호 메서드 표시

	메서드		정의 주체
		addListenerHandler():void Sets up all of the listeners for the valid and invalid events dispatched from the validator.	Validator
		doValidation(value:Object):Array [재정의] Override of the base class doValidation() method to validate a date.	DateValidator
		getValueFromSource():Object Returns the Object to validate.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Returns a ValidationResultEvent from the Array of error results.	Validator
		isRealValue(value:Object):Boolean Returns true if value is not null.	Validator
		removeListenerHandler():void Disconnects all of the listeners for the valid and invalid events dispatched from the validator.	Validator
		resourcesChanged():void This method is called when a Validator is constructed, and again whenever the ResourceManager dispatches a "change" Event to indicate that the localized resources have changed in some way.	Validator

이벤트

이벤트에 대한 자세한 내용을 보려면 클릭하십시오.

상속되는 이벤트 숨기기

상속되는 이벤트 표시

	요약	정의 주체
activate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
deactivate	[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
invalid	Dispatched when validation fails.	Validator
valid	Dispatched when validation succeeds.	Validator

보호 상수

상속되는 보호 상수 숨기기

상속되는 보호 상수 표시

	상수		정의 주체

속성 세부 정보

allowedFormatChars

속성

allowedFormatChars:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

The set of formatting characters allowed for separating the month, day, and year values.

기본값: "/\-. ".

구현
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void

dayListener

속성

dayListener:IValidatorListener

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

The component that listens for the validation result for the day subfield. If none is specified, use the value specified for the daySource property.

구현
public function get dayListener():IValidatorListener
public function set dayListener(value:IValidatorListener):void

dayProperty

속성

public var dayProperty:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Name of the day property to validate. This property is optional, but if you specify the daySource property, you should also set this property.

daySource

속성

daySource:Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Object that contains the value of the day field. If you specify a value for this property, you must also specify a value for the dayProperty property. Do not use this property if you set the source and property properties.

구현
public function get daySource():Object
public function set daySource(value:Object):void

formatError

속성

formatError:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Error message when the inputFormat property is not in the correct format.

기본값: "Configuration error: Incorrect formatting string.".

구현
public function get formatError():String
public function set formatError(value:String):void

inputFormat

속성

inputFormat:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

The date format to validate the value against. "MM" is the month, "DD" is the day, and "YYYY" is the year. This String is case-sensitive.

기본값: "MM/DD/YYYY".

구현
public function get inputFormat():String
public function set inputFormat(value:String):void

invalidCharError

속성

invalidCharError:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Error message when there are invalid characters in the date.

기본값: "Invalid characters in your date.".

구현
public function get invalidCharError():String
public function set invalidCharError(value:String):void

monthListener

속성

monthListener:IValidatorListener

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

The component that listens for the validation result for the month subfield. If none is specified, use the value specified for the monthSource property.

구현
public function get monthListener():IValidatorListener
public function set monthListener(value:IValidatorListener):void

monthProperty

속성

public var monthProperty:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Name of the month property to validate. This property is optional, but if you specify the monthSource property, you should also set this property.

monthSource

속성

monthSource:Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Object that contains the value of the month field. If you specify a value for this property, you must also specify a value for the monthProperty property. Do not use this property if you set the source and property properties.

구현
public function get monthSource():Object
public function set monthSource(value:Object):void

validateAsString

속성

validateAsString:Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Determines how to validate the value. If set to true, the validator evaluates the value as a String, unless the value has a month, day, or year property. If false, the validator evaluates the value as a Date object.

기본값: true.

구현
public function get validateAsString():Object
public function set validateAsString(value:Object):void

wrongDayError

속성

wrongDayError:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Error message when the day is invalid.

기본값: "Enter a valid day for the month.".

구현
public function get wrongDayError():String
public function set wrongDayError(value:String):void

wrongLengthError

속성

wrongLengthError:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Error message when the length of the date doesn't match that of the inputFormat property.

기본값: "Type the date in the format inputFormat.".

구현
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void

wrongMonthError

속성

wrongMonthError:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Error message when the month is invalid.

기본값: "Enter a month between 1 and 12.".

구현
public function get wrongMonthError():String
public function set wrongMonthError(value:String):void

wrongYearError

속성

wrongYearError:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Error message when the year is invalid.

기본값: "Enter a year between 0 and 9999.".

구현
public function get wrongYearError():String
public function set wrongYearError(value:String):void

yearListener

속성

yearListener:IValidatorListener

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

The component that listens for the validation result for the year subfield. If none is specified, use the value specified for the yearSource property.

구현
public function get yearListener():IValidatorListener
public function set yearListener(value:IValidatorListener):void

yearProperty

속성

public var yearProperty:String

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Name of the year property to validate. This property is optional, but if you specify the yearSource property, you should also set this property.

yearSource

속성

yearSource:Object

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Object that contains the value of the year field. If you specify a value for this property, you must also specify a value for the yearProperty property. Do not use this property if you set the source and property properties.

구현
public function get yearSource():Object
public function set yearSource(value:Object):void

생성자 세부 정보

()

생성자

public function DateValidator()

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Constructor.

메서드 세부 정보

doValidation

()

메서드

override protected function doValidation(value:Object):Array

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Override of the base class doValidation() method to validate a date.

You do not call this method directly; Flex calls it as part of performing a validation. If you create a custom validator class, you must implement this method.

매개 변수

value:Object — Either a String or an Object to validate.

반환값

Array — An Array of ValidationResult objects, with one ValidationResult object for each field examined by the validator.

validateDate

()

메서드

public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array

언어 버전:

ActionScript 3.0

제품 버전:

Flex 3

런타임 버전:

Flash Player 9, AIR 1.1

Convenience method for calling a validator from within a custom validation function. Each of the standard Flex validators has a similar convenience method.

매개 변수

	`validator:DateValidator` — The DateValidator instance.

	`value:Object` — A field to validate.

	`baseField:String` — Text representation of the subfield specified in the value parameter. For example, if the `value` parameter specifies value.date, the `baseField` value is "date".

반환값

Array — An Array of ValidationResult objects, with one ValidationResult object for each field examined by the validator.

DateValidator - AS3 Flex

패키지x

언어 요소

부록

패키지 mx.validators

allowedFormatChars

dayListener

dayProperty

daySource

formatError

inputFormat

invalidCharError

monthListener

monthProperty

monthSource

validateAsString

wrongDayError

wrongLengthError

wrongMonthError

wrongYearError

yearListener

yearProperty

yearSource

DateValidator

doValidation

validateDate