DateValidator

Package	mx.validators
Classe	public class DateValidator
Héritage	DateValidator Validator EventDispatcher Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

La classe DateValidator valide le fait qu’une chaîne, qu’une date ou qu’un objet contient une date correcte correspondant à un format spécifié. Les utilisateurs peuvent entrer un seul chiffre ou deux chiffres pour le mois, le jour et l’année. Par défaut, le programme de validation assure les formats suivants :

Le mois est compris entre 1 et 12 (ou 0-11 pour les objets Date).
Le jour est compris entre 1 et 31.
L’année est un nombre.

Vous pouvez spécifier la date dans la classe DateValidator de deux manières :

Une seule classe String contenant la date - Utilisez les propriétés source et property pour spécifier la classe String. La classe Chaîne peut contenir des chiffres et les caractères de formatage spécifiés par la propriété allowedFormatChars, qui incluent les caractères "/\-.". Par défaut, le format d’entrée de la date dans un champ String est « MM/DD/YYYY », « MM » correspondant au mois, « DD » au jour et « YYYY » à l’année. Vous pouvez utiliser la propriété inputFormat pour spécifier un format différent.
Objet Date.
Champs Object ou champs multiples contenant le jour, le mois et l’année. Utilisez l’ensemble des propriétés suivantes pour spécifier le jour, le mois et l’année : daySource, dayProperty, monthSource, monthProperty, yearSource et yearProperty.

Syntaxe MXML expanded

Masquer la syntaxe 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"
  />

Consulter les exemples

Propriétés publiques

Masquer les propriétés publiques héritées

Afficher les propriétés publiques héritées

	Propriété		Défini par
		allowedFormatChars : String Jeu de caractères de formatage autorisés pour séparer les valeurs month, day et year.	DateValidator
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		dayListener : IValidatorListener Composant qui écoute le résultat de validation pour le sous-champ day.	DateValidator
		dayProperty : String Nom de la propriété day à valider.	DateValidator
		daySource : Object Objet contenant la valeur du champ day.	DateValidator
		enabled : Boolean Si cette valeur est définie sur false, le programme de validation arrête la validation.	Validator
		formatError : String Message d’erreur si le format de la propriété inputFormat n’est pas correct.	DateValidator
		inputFormat : String Format de date par rapport auquel valider la valeur.	DateValidator
		invalidCharError : String Message d’erreur lorsque la date contient des caractères non valides.	DateValidator
		listener : Object Spécifie l’écouteur de validation.	Validator
		monthListener : IValidatorListener Composant qui écoute le résultat de validation pour le sous-champ month.	DateValidator
		monthProperty : String Nom de la propriété month à valider.	DateValidator
		monthSource : Object Objet contenant la valeur du champ month.	DateValidator
		property : String Chaîne spécifiant le nom de la propriété de l’objet source qui contient la valeur à valider.	Validator
		required : Boolean = true Si true, indique qu’une valeur manquante ou vide provoque une erreur de validation.	Validator
		requiredFieldError : String Message d’erreur lorsqu’une valeur est manquante et que la propriété requise est true.	Validator
		source : Object Spécifie l’objet contenant la propriété à valider.	Validator
		trigger : IEventDispatcher Spécifie le composant qui génère l’événement déclenchant le programme de validation.	Validator
		triggerEvent : String Spécifie l’événement qui déclenche la validation.	Validator
		validateAsString : Object Détermine comment valider la valeur.	DateValidator
		wrongDayError : String Message d’erreur lorsque le jour n’est pas valide.	DateValidator
		wrongLengthError : String Message d’erreur lorsque la longueur de la date ne correspond pas à celle spécifiée par la propriété inputFormat.	DateValidator
		wrongMonthError : String Message d’erreur lorsque le mois n’est pas valide.	DateValidator
		wrongYearError : String Message d’erreur lorsque l’année n’est pas valide.	DateValidator
		yearListener : IValidatorListener Composant qui écoute le résultat de validation pour le sous-champ année.	DateValidator
		yearProperty : String Nom de la propriété year à valider.	DateValidator
		yearSource : Object Objet contenant la valeur du champ year.	DateValidator

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		actualListeners : Array [lecture seule] Contient un tableau d’objets d’écouteurs, le cas échéant, ou l’objet source.	Validator
		actualTrigger : IEventDispatcher [lecture seule] Contient l’objet déclencheur, le cas échéant, ou l’objet source.	Validator
		resourceManager : IResourceManager [lecture seule] Référence à l’objet qui gère toutes les ressources localisées de l’application.	Validator
		subFields : Array Tableau de chaînes contenant les noms des propriétés contenues dans l’objet value transmis à la méthode validate().	Validator

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		DateValidator() Constructeur.	DateValidator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialized(document:Object, id:String):void Appelé automatiquement par le compilateur MXML lorsque la classe Validator est créée à l’aide d’une balise MXML.	Validator
		isPrototypeOf(theClass:Object):Boolean Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre.	Object
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l’objet spécifié.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Procède à la validation et, le cas échéant, informe les écouteurs du résultat.	Validator
		validateAll(validators:Array):Array [statique] Invoque tous les objets Validator dans le tableau d’objets Validator.	Validator
		validateDate(validator:DateValidator, value:Object, baseField:String):Array [statique] Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée.	DateValidator
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	EventDispatcher

Méthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		addListenerHandler():void Définit tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	Validator
		doValidation(value:Object):Array [override] Remplace la méthode doValidation() de la classe de base pour valider une date.	DateValidator
		getValueFromSource():Object Renvoie l’objet à valider.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Renvoie une classe ValidationResultEvent depuis le tableau des résultats d’erreurs.	Validator
		isRealValue(value:Object):Boolean Renvoie true si la valeur n’est pas nulle.	Validator
		removeListenerHandler():void Déconnecte tous les écouteurs pour les événements valid et invalid distribués à partir du programme de validation.	Validator
		resourcesChanged():void Cette méthode est appelée lorsqu’une classe Validator est construite et chaque fois que la classe ResourceManager distribue un événement « change » pour indiquer que les ressources localisées ont changé d’une manière ou d’une autre.	Validator

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
invalid	Distribué si la validation échoue.	Validator
valid	Distribué si la validation réussit.	Validator

Constantes protégées

Masquer les constantes protégées héritées

Afficher les constantes protégées héritées

	Constante		Défini par

Détails de la propriété

allowedFormatChars

propriété

allowedFormatChars:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Jeu de caractères de formatage autorisés pour séparer les valeurs month, day et year.

La valeur par défaut est "/\-. ".

Implémentation
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void

dayListener

propriété

dayListener:IValidatorListener

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Composant qui écoute le résultat de validation pour le sous-champ day. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété daySource.

Implémentation
public function get dayListener():IValidatorListener
public function set dayListener(value:IValidatorListener):void

dayProperty

propriété

public var dayProperty:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Nom de la propriété day à valider. Cette propriété est facultative, mais si vous spécifiez la propriété daySource, définissez également cette propriété.

daySource

propriété

daySource:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet contenant la valeur du champ day. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété dayProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.

Implémentation
public function get daySource():Object
public function set daySource(value:Object):void

formatError

propriété

formatError:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Message d’erreur si le format de la propriété inputFormat n’est pas correct.

La valeur par défaut est "Configuration error: Incorrect formatting string.".

Implémentation
public function get formatError():String
public function set formatError(value:String):void

inputFormat

propriété

inputFormat:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Format de date par rapport auquel valider la valeur. « MM » correspond au mois, « DD » au jour et « YYYY » à l’année. Cette chaîne est sensible à la casse.

La valeur par défaut est "MM/DD/YYYY".

Implémentation
public function get inputFormat():String
public function set inputFormat(value:String):void

invalidCharError

propriété

invalidCharError:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Message d’erreur lorsque la date contient des caractères non valides.

La valeur par défaut est "Invalid characters in your date.".

Implémentation
public function get invalidCharError():String
public function set invalidCharError(value:String):void

monthListener

propriété

monthListener:IValidatorListener

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Composant qui écoute le résultat de validation pour le sous-champ month. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété monthSource.

Implémentation
public function get monthListener():IValidatorListener
public function set monthListener(value:IValidatorListener):void

monthProperty

propriété

public var monthProperty:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Nom de la propriété month à valider. Cette propriété est facultative, mais si vous spécifiez la propriété monthSource, définissez également cette propriété.

monthSource

propriété

monthSource:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet contenant la valeur du champ month. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété monthProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.

Implémentation
public function get monthSource():Object
public function set monthSource(value:Object):void

validateAsString

propriété

validateAsString:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Détermine comment valider la valeur. Si défini sur true, le programme de validation évalue la valeur en tant qu’objet String, sauf si elle comporte une propriété month, day ou year. Si false, le programme de validation évalue la valeur en tant qu’objet Date.

La valeur par défaut est true.

Implémentation
public function get validateAsString():Object
public function set validateAsString(value:Object):void

wrongDayError

propriété

wrongDayError:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Message d’erreur lorsque le jour n’est pas valide.

La valeur par défaut est "Enter a valid day for the month.".

Implémentation
public function get wrongDayError():String
public function set wrongDayError(value:String):void

wrongLengthError

propriété

wrongLengthError:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Message d’erreur lorsque la longueur de la date ne correspond pas à celle spécifiée par la propriété inputFormat.

La valeur par défaut est "Type the date in the format inputFormat.".

Implémentation
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void

wrongMonthError

propriété

wrongMonthError:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Message d’erreur lorsque le mois n’est pas valide.

La valeur par défaut est "Enter a month between 1 and 12.".

Implémentation
public function get wrongMonthError():String
public function set wrongMonthError(value:String):void

wrongYearError

propriété

wrongYearError:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Message d’erreur lorsque l’année n’est pas valide.

La valeur par défaut est "Enter a year between 0 and 9999.".

Implémentation
public function get wrongYearError():String
public function set wrongYearError(value:String):void

yearListener

propriété

yearListener:IValidatorListener

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Composant qui écoute le résultat de validation pour le sous-champ année. Si aucune valeur n’est spécifiée, utilisez la valeur spécifiée pour la propriété yearSource.

Implémentation
public function get yearListener():IValidatorListener
public function set yearListener(value:IValidatorListener):void

yearProperty

propriété

public var yearProperty:String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Nom de la propriété year à valider. Cette propriété est facultative, mais si vous spécifiez la propriété yearSource, définissez également cette propriété.

yearSource

propriété

yearSource:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Objet contenant la valeur du champ year. Si vous spécifiez une valeur pour cette propriété, vous devez aussi en spécifier une pour la propriété yearProperty. N’utilisez pas cette propriété si vous définissez les propriétés source et property.

Implémentation
public function get yearSource():Object
public function set yearSource(value:Object):void

Détails du constructeur

()

Constructeur

public function DateValidator()

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Constructeur.

Détails de la méthode

doValidation

()

méthode

override protected function doValidation(value:Object):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Remplace la méthode doValidation() de la classe de base pour valider une date.

Vous n’appelez pas cette méthode directement ; Flex l’appelle dans le cadre d’une validation. Si vous créez une classe Validator personnalisée, vous devez implémenter cette méthode.

Paramètres

value:Object — Classe String ou classe Object à valider.

Valeur renvoyée

Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.

validateDate

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Méthode pratique pour appeler une classe Validator dans une fonction de validation personnalisée. Chacune des classes Validator Flex standard comporte une méthode pratique similaire.

Paramètres

	`validator:DateValidator` — Instance DateValidator.

	`value:Object` — Champ à valider.

	`baseField:String` — Représentation textuelle du sous-champ spécifié dans le paramètre value. Par exemple, si le paramètre `value` spécifie value.date, la valeur `baseField` est « date ».

Valeur renvoyée

Array — Tableau d’objets ValidationResult, avec un objet ValidationResult pour chaque champ examiné par le programme de validation.

Eléments de l’API associés

mx.validators.ValidationResult

Exemples Comment utiliser cet exemple

DateValidatorExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the DateValidator. -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009"
        xmlns:s="library://ns.adobe.com/flex/spark"
        xmlns:mx="library://ns.adobe.com/flex/mx">

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

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

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

    <s:Panel title="DateValidator Example"
            width="75%" height="75%" 
            horizontalCenter="0" verticalCenter="0">
        <mx:Form left="10" right="10" top="10" bottom="10">
            <mx:FormItem label="Enter date of birth (mm/dd/yyyy): ">
                <s:TextInput id="dob" width="100%"/>
            </mx:FormItem>
            <mx:FormItem >
                <s:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </s:Panel>

</s:Application>

Informations juridiques | Politique de confidentialité en ligne

DateValidator - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.validators

allowedFormatChars

dayListener

dayProperty

daySource

formatError

inputFormat

invalidCharError

monthListener

monthProperty

monthSource

validateAsString

wrongDayError

wrongLengthError

wrongMonthError

wrongYearError

yearListener

yearProperty

yearSource

DateValidator

doValidation

validateDate