D-E >

Date (objet)

L'objet Date vous permet de récupérer les valeurs horaires en fonction du temps universel (Temps moyen de Greenwich, maintenant appelé Temps Universel Coordonné) ou en fonction du système d'exploitation sur lequel Flash Player est exécuté. Les méthodes de l'objet Date ne sont pas statiques, mais ne s'appliquent qu'à l'occurrence de l'objet Date spécifiée à l'appel de la méthode. La méthode Date.UTC est une exception : c'est une méthode statique.

L'objet Date gère l'heure d'été différemment suivant le système d'exploitation et la version de Flash Player. Flash Player 6 gère l'heure d'été sur les systèmes d'exploitation suivants comme suit :

	Windows - l'objet Date ajuste automatiquement son résultat pour refléter l'heure d'été. L'objet Date détecte si l'heure d'été est employée à l'endroit en question et, si c'est le cas, détecte les dates et heures de transition de l'heure d'hiver à l'heure d'été. Cependant, les dates de transition actuellement en vigueur sont appliquées aux dates passées et futures, et l'écart dû à l'heure d'été peut donc être calculé de façon incorrecte pour les dates passées lorsque le lieu en question avait des dates de transition différentes.
	Mac OS 8 et 9 - l'objet Date utilise l'écart actuel dû à l'heure d'été, quelle que soit la date ou l'heure calculée. Par exemple, dans le fuseau horaire Pacifique des Etats-Unis en août, lorsque l'heure d'été est en vigueur, un objet Date contenant la date du 1er janvier 2001 indique toujours l'heure d'été, bien que l'heure d'été ne soit pas en vigueur en janvier. Ce problème ne peut pas être corrigé sous Mac OS 8 ou 9 étant donné qu'aucune base de données d'informations de fuseau horaire n'est disponible.
	Mac OS X - l'objet Date ajuste automatiquement son résultat pour refléter l'heure d'été. La base de données d'informations de fuseau horaire sous Mac OS X est utilisée pour déterminer si un écart dû à l'heure d'été devrait être appliqué à une date ou à une heure présente ou passée.

Flash Player 5 gère l'heure d'été sur les systèmes d'exploitation suivants comme suit :

	Mac OS 8 et 9 - le comportement est le même que celui décrit pour Flash Player 6.
	Windows - les règles utilisées aux Etats-Unis pour l'heure d'été sont toujours appliquées, ce qui donne lieu à des transitions incorrectes en Europe et dans d'autres régions qui utilisent l'heure d'été mais ont des dates de transition différentes de celles des Etats-Unis. Flash détecte correctement si l'heure d'été est employée à l'endroit en question.

Pour appeler les méthodes de l'objet Date, vous devez d'abord créer une occurrence de l'objet Date en utilisant son constructeur.

L'objet Date requiert Flash Player 5.

 
Méthodes de l'objet Date

Méthode	Description
Date.getDate	Renvoie le jour du mois, en fonction de l'heure locale.
Date.getDay	Renvoie le jour de la semaine, en fonction de l'heure locale.
Date.getFullYear	Renvoie l'année (quatre chiffres), en fonction de l'heure locale.
Date.getHours	Renvoie l'heure, en fonction de l'heure locale.
Date.getMilliseconds	Renvoie les millisecondes, en fonction de l'heure locale.
Date.getMinutes	Renvoie les minutes, en fonction de l'heure locale.
Date.getMonth	Renvoie le mois, en fonction de l'heure locale.
Date.getSeconds	Renvoie les secondes, en fonction de l'heure locale.
Date.getTime	Renvoie le nombre de millisecondes écoulées depuis le premier janvier 1970 à minuit, temps universel.
Date.getTimezoneOffset	Renvoie la différence, en minutes, entre l'heure locale de l'ordinateur et le temps universel.
Date.getUTCDate	Renvoie le jour (date) du mois, en fonction du temps universel.
Date.getUTCDay	Renvoie le jour de la semaine, en fonction du temps universel.
Date.getUTCFullYear	Renvoie l'année (quatre chiffres), en fonction du temps universel.
Date.getUTCHours	Renvoie l'heure, en fonction du temps universel.
Date.getUTCMilliseconds	Renvoie les millisecondes, en fonction du temps universel.
Date.getUTCMinutes	Renvoie les minutes, en fonction du temps universel.
Date.getUTCMonth	Renvoie le mois, en fonction du temps universel.
Date.getUTCSeconds	Renvoie les secondes, en fonction du temps universel.
Date.getYear	Renvoie l'année, en fonction de l'heure locale.
Date.setDate	Définit le jour du mois, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setFullYear	Définit l'année complète, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setHours	Définit l'heure, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setMilliseconds	Définit les millisecondes, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setMinutes	Définit les minutes, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setMonth	Définit le mois, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setSeconds	Définit les secondes, en fonction de l'heure locale. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setTime	Définit la date, en millisecondes. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCDate	Définit la date, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCFullYear	Définit l'année, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCHours	Définit l'heure, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCMilliseconds	Définit les millisecondes, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCMinutes	Définit les minutes, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCMonth	Définit le mois, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setUTCSeconds	Définit les secondes, en fonction du temps universel. Renvoie les nouvelles informations horaires, en millisecondes.
Date.setYear	Définit l'année, en fonction de l'heure locale.
Date.toString	Renvoie une valeur de chaîne représentant la date et l'heure stockées dans l'objet Date spécifié.
Date.UTC	Renvoie le nombre de millisecondes écoulées entre le premier janvier 1970 à minuit, temps universel, et l'heure spécifiée.

 
Constructeur de l'objet Date

Disponibilité

Flash Player 5.

Usage

new Date()
new Date(année, mois [, date [, heure [, minute [, seconde [, milliseconde ]]]]])

Paramètres

année Une valeur entre 0 et 99 indique une année entre 1900 et 1999, sinon, les quatre chiffres de l'année doivent être spécifiés.

mois Un entier compris entre 0 (janvier) et 11 (décembre).

date Un entier compris entre 1 et 31. Ce paramètre est facultatif.

heure Un entier compris entre 0 (minuit) et 23 (23h00).

minute Un entier compris entre 0 et 59. Ce paramètre est facultatif.

seconde Un entier compris entre 0 et 59. Ce paramètre est facultatif.

milliseconde Un entier compris entre 0 et 999. Ce paramètre est facultatif.

Renvoie

Un entier.

Description

Objet ; construit un nouvel objet Date contenant les informations horaires actuelles ou la date spécifiée.

Exemple

L'exemple suivant récupère l'heure et la date actuelles.

maintenant = new Date();

L'exemple suivant crée un nouvel objet Date pour l'anniversaire de Gary, le 7 août 1974.

anniversaire_gary = new Date (74, 7, 7); 

L'exemple suivant crée un nouvel objet Date, concatène les valeurs renvoyées des méthodes getMonth, getDate et getFullYear et les affiche dans le champ de texte spécifié par la variable dateTextField.

maDate = new Date();
dateTextField = ((maDate.getMonth() + 1) + "/" + maDate.getDate() + "/" + maDate.getFullYear());