Rubrique précédenteRubrique suivante


Classe DateTimeSpan

La classe statique DateTimeSpan fournit des fonctions permettant de déterminer le lapse de temps entre deux dates ou horaires, et d'ajouter ou de soustraire des durées de temps. Elle offre un ensemble de fonctions permettant de travailler avec la différence entre deux dates. Puisque les intervalles de date ne sont que des nombres, l'application peut leur appliquer des opérations mathématiques simples : multiplication, division, addition, soustraction et ainsi de suite. Cette classe est statique. L'application ne peut pas créer d'instances de cette classe.

DateTimeSpan.addDate

Cette fonction renvoie une nouvelle date qui est le résultat de la somme du nombre donné d'années, de mois et de jours avec la date de début. Les mois peuvent être supérieurs à 12, et les jours peuvent être supérieurs au nombre de jours dans un mois. Le résultat final étant comme s'il existait trois opérations différentes. Ajoutez d'abord les années. Puis, utilisez la date résultante et ajoutez les mois. Ensuite, à l'aide de la date résultante, ajoutez les jours.

Lors de l'ajout d'un mois, la date résultante peut ne pas être valide. Par exemple, l'ajout d'un mois au 31 Janv. produira la date incorrecte du 31 Fév. La fonction ajuste la date pour qu'elle soit valide, dans ce cas, si l'année n'est pas une année bissextile, alors le mois de février compte 28 jours et la date résultante est le 3 mars.

Tous les arguments d'années, de mois ou de jours peuvent être null ou non définis. Dans ce cas, cette valeur est considérée comme étant zéro.

Tous les arguments d'années, de mois ou de jours peuvent être négatifs. Dans ce cas, le résultat est comme si l'unité était soustraite de la date de base.

Syntaxe

DateTimeSpan.addDate( startDate, années, mois, jours )

Arguments

Renvoie

Une date qui résulte de l'ajout des années, des mois et des jours à la date de début.

Exemple

var startDate = date.parse( "2004-12-31" ); 
var endDate; 
endDate = DateTimeSpan( startDate, 1, 0, 0 ); // renvoie 2005-12-31 
endDate = DateTimeSpan( startDate, 0, 1, 0 ); // renvoie 2005-1-31 
endDate = DateTimeSpan( startDate, 0, 0, 1 ); // renvoie 2005-1-1 
endDate = DateTimeSpan( startDate, 1, 1, 1 ); // renvoie 2005-3-4 

Voir également

La fonction DateTimeSpan.addTime

La fonction DateTimeSpan.subDate

DateTimeSpan.addTime

Cette fonction renvoie une nouvelle date qui est le résultat de la somme du nombre donné d'heures, de minutes et de secondes avec la date de début. Les heures peuvent être supérieures à 24, et les minutes et les secondes supérieures à 60. Le résultat final étant comme s'il existait trois opérations différentes : ajoutez d'abord les heures. Puis, utilisez la date résultante et ajoutez les minutes. Ensuite, à l'aide de la date résultante, ajoutez les secondes.

Tous les arguments d'heures, de minutes ou de secondes peuvent être null ou non définis. Dans ce cas, cette valeur est considérée comme étant zéro.

Tous les arguments d'heures, de minutes ou de secondes peuvent être négatifs. Dans ce cas, le résultat est comme si l'unité était soustraite de la date de base.

Syntaxe

DateTimeSpan.addTime( startDate, heures, minutes, secondes )

Arguments

Renvoie

Une date qui résulte de l'ajout des heures, des minutes et des secondes à la date de début.

Voir également

La fonction DateTimeSpan.addDate

la fonction DateTimeSpan.subTime

DateTimeSpan.days

Renvoie le nombre de jours entre deux dates. Un jour est défini comme un changement dans le calendrier. Ainsi, le 27 février 11:59:59 PM au 28 février à Minuit constitue un jour, comme le 27 février à minuit au 28 février à 11:59:59.

Syntaxe

DateTimeSpan.days( startDate, endDate )

Arguments

Renvoie

Renvoie le nombre de jours entre deux dates.

DateTimeSpan.hours

Cette fonction renvoie le nombre d'heures complètes entre deux horaires. Une heure complète est définie comme un intervalle depuis une minute donnée d'une heure jusqu'à la même minute d'une autre heure. Par exemple, 1:23:00 à 2:23:00 constitue une heure, tandis que 1:23:00 à 2:22:59 n'est pas une heure complète.

Syntaxe

DateTimeSpan.hours( startDate, endDate )

Arguments

Renvoie

Le nombre d'heures complètes entre deux dates.

DateTimeSpan.minutes

Cette fonction renvoie le nombre de minutes complètes entre deux horaires. Une minute complète est définie comme un intervalle depuis une seconde donnée d'une minute jusqu'à la même seconde d'une autre minute. Par exemple, 1:23:00 à 1:24:00 constitue une minute, tandis que 1:23:00 à 1:22:59 n'est pas une minute complète.

Syntaxe

DateTimeSpan.minutes( startDate, endDate )

Arguments

Renvoie

Le nombre de minutes complètes entre deux dates.

DateTimeSpan.months

Cette fonction renvoie le nombre de mois complets entre deux dates. Un mois complet est définit comme une étendue de temps entre un jour d'un mois et le même jour du mois suivant. Par exemple, la période du 28 février au 28 mars constitue un mois, alors que la période du 28 février ou 26 mars n'est pas un mois complet.

Syntaxe

DateTimeSpan.months( startDate, endDate )

Arguments

Renvoie

Renvoie le nombre de mois complets entre deux dates.

DateTimeSpan.seconds

Cette fonction renvoie le nombre de secondes entre deux horaires.

Syntaxe

DateTimeSpan.seconds( startDate, endDate )

Arguments

Renvoie

Le nombre de minutes complètes entre deux dates.

DateTimeSpan.subDate

Cette fonction renvoie une nouvelle date qui est le résultat de la soustraction du nombre donné d'années, de mois et de jours avec la date de début. Les mois peuvent être supérieurs à 12, et les jours peuvent être supérieurs au nombre de jours dans un mois. Le résultat final étant comme s'il existait trois opérations différentes. Soustrayez d'abord les années. Puis, utilisez la date résultante et soustrayez les mois. Ensuite, à l'aide de la date résultante, soustrayez les jours.

Lors de la soustraction d'un mois, la date résultante peut ne pas être valide. Par exemple, la soustraction d'un mois à partir du 30 mars produirait la date invalide du 30 février. Cette fonction ajuste la date de sorte quelle soit valide, tout en intégrant le dernier jour valide du mois. Dans ce cas, si l'année n'est pas une année bissextile, la date serait ajustée au 28 février.

Tous les arguments d'années, de mois ou de jours peuvent être null ou non définis. Dans ce cas, cette valeur est considérée comme étant zéro.

Tous les arguments d'années, de mois ou de jours peuvent être négatifs. Dans ce cas, le résultat est comme si l'unité était ajoutée à la date de base.

Syntaxe

DateTimeSpan.subDate( startDate, années, mois, jours )

Arguments

Renvoie

Une date qui résulte de la soustraction des années, des mois et des jours de la date de début.

Voir également

La fonction DateTimeSpan.addDate

la fonction DateTimeSpan.subTime

DateTimeSpan.subTime

Cette fonction renvoie une nouvelle date qui est le résultat de la soustraction du nombre donné d'heures, de minutes et de secondes avec la date de début. Les heures peuvent être supérieures à 24, et les minutes et les secondes supérieures à 60. Le résultat final étant comme s'il existait trois opérations différentes. Soustrayez d'abord les heures. Puis, utilisez la date résultante et soustrayez les minutes. Ensuite, à l'aide de la date résultante, soustrayez les secondes.

Tous les arguments d'heures, de minutes ou de secondes peuvent être null ou non définis. Dans ce cas, cette valeur est considérée comme étant zéro.

Tous les arguments d'heures, de minutes ou de secondes peuvent être négatifs. Dans ce cas, le résultat est comme si l'unité était ajoutée à la date de base.

Syntaxe

DateTimeSpan.subTime( startDate, heures, minutes, secondes )

Arguments

Renvoie

Une date qui résulte de la soustraction des heures, des minutes et des secondes de la date de début.

Voir également

La fonction DateTimeSpan.addTime

La fonction DateTimeSpan.subDate

DateTimeSpan.years

Cette fonction calcule le nombre d'années complètes entre deux dates. Une année complète est définit comme allant d'un mois, d'un jour et d'une heure donnés d'une année aux mêmes mois, jour et heure de l'année suivante. A cause des années bissextiles, une année complète comprend 365 jours et parfois 366.

Si l'un des deux arguments n'est pas une date, un exception se produit. Si l'un des deux arguments est null, alors le résultat le sera également.

Syntaxe

DateTimeSpan.years( startDate, endDate )

Arguments

Renvoie

Le nombre d'années complètes entre deux dates.


(c) Copyright Actuate Corporation 2006

Rubrique précédenteRubrique suivante