La classe statique DateTimeSpan fournit des fonctions
permettant de déterminer le temps entre deux dates ou heures, d'ajouter ou de soustraire
des intervalles de temps ou d'obtenir des parties d'une date. Puisque les dates ne sont
que des nombres, l'application peut leur appliquer des opérations mathématiques simples :
multiplication, division, addition, soustraction, etc. Cette classe est statique. L'application ne peut pas créer d'instance de la classe.
Cette fonction renvoie une nouvelle date qui est
la somme du nombre donné de jours et d'une date. Le nombre de jours à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Objet Date. Objet date qui représente la date de début.
n
Objet Nombre. Le nombre de jours à ajouter à la date. Les nombres décimaux sont traités comme des entiers, arrondis vers l'entier inférieur le plus proche.
Renvoie
Objet Date. Date qui résulte de l'ajout du nombre de jours
défini à la date de début.
Exemples
Les exemples suivants ajoutent des jours à une date :
Les exemples suivants ajoutent 15 jours à chaque date dans la zone InvoiceDate :
Cette fonction renvoie une nouvelle date
qui est la somme du nombre donné d'heures et d'une date. Le nombre d'heures à ajouter peut
être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Un objet date qui représente la date de début. Si une date de début n'a pas d'heure,
la fonction suppose que l'heure correspond à minuit (00:00:00).
n
Objet Nombre. Nombre d'heures à ajouter à la date.
Renvoie
Objet Date. Date qui résulte de l'ajout du nombre
d'heures défini à la date de début.
Exemples
L'exemple suivant ajoute des heures à une date et
une heure :
L'exemple suivant ajoute 36 jours à chaque date
dans la zone StartTime :
Cette fonction renvoie une nouvelle date qui est
la somme du nombre donné de minutes et d'une date. Le nombre de minutes à ajouter
peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Objet date qui représente la date de début. Si une date de début n'a pas d'heure,
la fonction suppose que l'heure correspond à minuit (00:00:00).
n
Objet Nombre. Nombre de minutes à ajouter à la date.
Renvoie
Objet Date. Date qui résulte de l'ajout du nombre
de minutes défini à la date de début.
Exemples
Les exemples suivants ajoutent
des heures à une date et une heure :
L'exemple suivant ajoute 15 minutes à
chaque date dans la zone StartTime :
Cette fonction renvoie une nouvelle date qui
est la somme du nombre donné de mois et d'une date. Le nombre de mois à ajouter
peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Cette fonction renvoie toujours une date valide. Si nécessaire, la partie jour de
la date résultante est ajustée vers le bas sur le dernier jour du mois résultant de l'année
résultante. Par exemple, si vous ajoutez 1 mois à 31 janvier 2008, addMonth( ) renvoie
29 février 2008 (2008 est une année bissextile) et non pas 31 février 2008.
Syntaxe
Paramètres
date
Objet Date. Objet date qui représente la date de début.
n
Objet Nombre. Le nombre de mois à ajouter à la date. Les nombres décimaux sont traités comme des entiers, arrondis vers le nombre inférieur.
Renvoie
Objet Date. Date qui résulte de l'ajout du nombre
de mois défini à la date de début.
Exemples
L'exemple suivant ajoute des mois à une date :
L'exemple suivant ajoute 10 mois à chaque date dans la zone InvoiceDate :
Cette fonction renvoie une nouvelle date qui est la
somme du nombre donné de trimestres et d'une date. Un trimestre est égal à trois mois. Par
exemple, si vous ajoutez 2 trimestres à 10 septembre 2008, la fonction retourne 10 mars 2009. Le nombre de
trimestres à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Un objet date qui représente la date de début.
n
Objet Nombre. Nombre de trimestres à ajouter à la date.
Renvoie
Objet Date. Date qui résulte de l'ajout du nombre
de trimestres défini à la date de début.
Exemples
L'exemple suivant ajoute des trimestres à une date :
L'exemple suivant ajoute 2 trimestres à chaque
date dans la zone ForecastClosing :
Cette fonction renvoie une nouvelle date
qui est la somme du nombre donné de secondes et d'une date. Le nombre de secondes
à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Un objet date qui représente la date de début. Si une date de début n'a pas d'heure,
la fonction suppose que l'heure correspond à minuit (00:00:00).
n
Objet Nombre. Nombre de secondes à ajouter à la date.
Renvoie
Objet Date. Résultat de l'ajout
du nombre de secondes défini à la date de début.
Exemples
L'exemple suivant ajoute des secondes à une
date et une heure :
L'exemple suivant ajoute 6000 secondes à chaque date
dans la zone StartTime :
Cette fonction renvoie une nouvelle date qui
est la somme du nombre donné de semaines et d'une date. Le nombre de semaines à ajouter
peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Un objet date qui représente la date de début.
n
Objet Nombre. Nombre de semaines à ajouter à la date.
Renvoie
Objet Date. Date qui résulte de l'ajout du nombre
de semaines défini à la date de début.
Exemples
L'exemple suivant ajoute des semaines à une date :
L'exemple suivant ajoute 2 semaines à chaque
date dans la zone InvoiceDate :
Cette fonction renvoie une nouvelle date qui est la somme
du nombre donné d'années et d'une date. Le nombre d'années à ajouter peut être négatif. Dans ce cas, cela revient à soustraire le nombre de la date.
Syntaxe
Paramètres
date
Un objet date qui représente la date de début.
n
Objet Nombre. Nombre d'années à ajouter à la date. Les nombres décimaux sont traités comme des entiers, arrondis vers le nombre inférieur.
Renvoie
Une date qui résulte de l'ajout du
nombre d'années défini à la date de début.
Exemples
L'exemple suivant ajoute des années à une date :
L'exemple suivant ajoute 5 années à chaque date
dans la zone HireDate :
Cette fonction retourne un nombre compris entre 1 et 31
qui correspond au jour du mois d'une date. Par exemple, si la date est 19 janvier 2009,
la fonction retourne 19.
Syntaxe
Paramètre
date
Objet Date. Objet date d'obtention du jour.
Renvoie
Entier qui correspond au jour du mois d'une date.
Exemples
L'exemple suivant retourne le jour du mois
de chaque valeur dans la zone ShipDate :
L'exemple suivant retourne le jour du mois de la
date en cours :
Cette fonction retourne le nombre de jours entre deux dates. Un jour est calculé en
soustrayant la valeur de jour de la première date de la valeur de jour de la seconde date. Par exemple,
si la première date est 30 décembre 2008 23:59:59 et la seconde date, 31 décembre 2008 00:00:00,
la fonction retourne 1 jour, même si une seule seconde sépare les deux dates.
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période..
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre de jours entre deux dates.
Exemples
Cette fonction retourne le nombre de jours entre deux dates :
L'exemple suivant renvoie le nombre de jours entre la date en cours et la fin de l'année 2009 :
L'exemple suivant renvoie le nombre de jours entre les valeurs qui figurent dans les zones InvoiceDate et PaymentDate :
Cette fonction retourne le nombre d'heures entre deux dates. Une heure
est calculée en soustrayant la valeur heure de la première date de la valeur heure de
la seconde date. Par exemple, si la première date est 31 janvier 2009 1:30:00 et la seconde date,
31 janvier 2000 2:00:00, la fonction retourne 1 jour, même si 30 minutes séparent les deux dates. Si une date de début n'a pas d'heure, la
fonction suppose que l'heure correspond à minuit (00:00:00).
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre d'heures entre deux dates.
Exemples
L'exemple suivant retourne le nombre d'heures
entre des dates :
L'exemple suivant retourne le nombre d'heures
entre la date en cours et la fin de l'année 2009 :
L'exemple suivant renvoie le nombre d'heures entre les valeurs figurant dans les zones StartTime et FinishTime :
Cette fonction retourne le nombre de minutes
entre deux dates. Une minute est calculée en soustrayant la valeur minutes
de la première date de la valeur minutes de la seconde date. Par exemple, si la première date
est 31 janvier 2009 1:30:59 et la seconde date, 31 janvier 2009 1:31:00, la fonction retourne 1 jour,
même si une seconde sépare les deux dates. Si une date de début n'a pas d'heure, la
fonction suppose que l'heure correspond à minuit (00:00:00).
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre de minutes entre deux dates.
Exemples
L'exemple suivant retourne le nombre de minutes
entre deux dates :
L'exemple suivant retourne le nombre de
minutes entre la date et l'heure en cours et le début de l'année 2010 :
L'exemple suivant renvoie le nombre de minutes entre les valeurs figurant dans les zones StartTime et FinishTime :
Cette fonction renvoie le nombre de mois entre deux dates. Un mois est calculé en soustrayant la valeur mois de la première date de la valeur mois de la seconde date. Par exemple, si la première date est 31 janvier 2009 et la seconde date 1er février 2009, la fonction renvoie 1 mois, même si un seul jour sépare les deux dates.
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre de mois entre deux dates.
Exemples
L'exemple suivant retourne le nombre de mois
entre des dates :
L'exemple suivant renvoie le nombre de mois entre la date en cours et le début de l'année 2010 :
L'exemple suivant renvoie le nombre de mois entre les valeurs figurant dans les zones ProjectStart et ProjectComplete :
Cette fonction retourne le nombre de trimestres
entre deux dates. Un trimestre est calculé en soustrayant la valeur mois
de la première date de la valeur mois de la seconde date. Une différence de 3 mois
correspond à 1 trimestre. Par exemple, si la première date est 31 janvier 2009 et la seconde date 1er juillet 2009, la fonction renvoie 2. Si la première date est 1er janvier 2009 et la seconde date 30 septembre 2009, la fonction renvoie aussi 2.
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre de trimestres entre deux dates.
Exemples
L'exemple suivant retourne le nombre de trimestres
entre deux dates :
L'exemple suivant renvoie le nombre de trimestres entre la date en cours et le début de l'année 2010 :
L'exemple suivant renvoie le nombre de trimestres entre les valeurs figurant dans les zones ProjectStart et ProjectComplete :
Cette fonction retourne le nombre de secondes entre
deux dates. Si une date de début n'a pas d'heure, la
fonction suppose que l'heure correspond à minuit (00:00:00).
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre de secondes entre deux dates.
Exemples
L'exemple suivant retourne le nombre de secondes
entre deux dates :
L'exemple suivant retourne le nombre de
secondes entre la date et l'heure en cours et le début de l'année 2010 :
L'exemple suivant renvoie le nombre de secondes entre les valeurs figurant dans les zones StartTime et FinishTime :
Cette fonction retourne le nombre de semaines
entre deux dates. Une semaine est calculée en soustrayant la valeur semaine
de la première date de la valeur semaine de la seconde date. Par exemple, si la première date
est 2 janvier 2009 (semaine 1 de l'année) et la seconde date, 5 janvier 2009 (semaine 2 de l'année),
la fonction retourne 1 jour, même si seulement 3 jours séparent les deux dates.
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre de semaines entre deux dates.
Exemples
L'exemple suivant retourne le nombre de semaines
entre deux dates :
L'exemple suivant renvoie le nombre de semaines entre la date en cours et le début de l'année 2010 :
L'exemple suivant renvoie le nombre de semaines entre les valeurs figurant dans les zones ProjectStart et ProjectComplete :
Cette fonction renvoie le nombre d'années entre deux dates. Une
année est calculée en soustrayant la valeur année de la première date de la valeur année
de la seconde date. Par exemple, si la première date est 1er janvier 2009 et la seconde date 31 décembre 2009, la fonction renvoie 0. Si la première date est 15 novembre 2008 et la seconde date 15 janvier 2009, la fonction renvoie 1.
Syntaxe
Paramètres
date1
Un objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre d'années entre deux dates.
Exemples
L'exemple suivant retourne le nombre d'années
entre deux dates :
L'exemple suivant retourne le nombre d'années
entre la valeur figurant dans la zone HireDate et la date en cours :
Cette fonction renvoie le nombre d'années entre deux dates. Une
année est calculée en soustrayant la valeur année de la première date de la valeur année
de la seconde date. Par exemple, si la première date est 1er janvier 2009 et la seconde date 31 décembre 2009, la fonction renvoie 0. Si la première date est 15 novembre 2008 et la seconde date 15 janvier 2009, la fonction renvoie 1.
Syntaxe
Paramètres
date1
Objet date qui représente le début de la période.
date2
Un objet date qui représente la fin de la période.
Renvoie
Entier. Nombre d'années entre deux dates.
Exemples
L'exemple suivant retourne le nombre d'années
entre deux dates :
L'exemple suivant retourne le nombre d'années
entre la valeur figurant dans la zone HireDate et la date en cours :
Cette fonction renvoie la date du premier jour du mois auquel la date d'entrée appartient.
Syntaxe
Paramètres
date
Objet date d'obtention du mois.
Renvoie
Objet Date. Premier jour du mois pour une date donnée.
Exemples
L'exemple suivant montre les valeurs mois
retournées pour une date données :
Cette fonction renvoie la date du premier jour du trimestre auquel la date d'entrée appartient.
Syntaxe
Paramètres
date
Objet date d'obtention du trimestre.
Renvoie
Objet Date. Premier jour du trimestre pour une date donnée.
Exemples
L'exemple suivant montre les valeurs trimestre
retournées pour une date donnée :
Cette fonction renvoie la date du premier jour de la semaine à laquelle appartient la date d'entrée, qui est toujours un lundi.
Syntaxe
Paramètres
date
Objet date d'obtention de la semaine.
Renvoie
Objet Date. Premier jour de la semaine pour une date donnée.
Exemples
L'exemple suivant montre les valeurs semaine retournées pour une date donnée :
Cette fonction renvoie la date du premier jour de l'année à laquelle la date d'entrée appartient.
Syntaxe
Paramètres
date
Objet date d'obtention de l'année.
Renvoie
Objet Date. Premier jour de l'année pour une date donnée.
Exemples
L'exemple suivant montre les valeurs année retournées pour une date donnée :
Cette fonction retourne le mois d'une date. Selon
l'option que vous spécifiez, cette fonction retourne le mois sous la forme
d'un nombre, le nom complet du mois ou le nom abrégé du mois. Le nom du mois est propre à l'environnement local.
Syntaxe
Paramètres
date
Objet date d'obtention du mois.
option
Entier. Facultatif. Nombre qui représente
le format de mois à retourner. Utilisez l'une des valeurs suivantes :
Si vous ne définissez pas cet argument,
la fonction retourne le mois sous la forme d'un nombre.
Renvoie
Chaîne. Mois pour une date donnée.
Exemples
L'exemple suivant montre les valeurs mois
retournées pour une date données :
L'exemple suivant retourne le mois de la date en cours :
Cette fonction retourne la date et
l'heure en cours, par exemple Feb 2, 2009 2:05 PM.
Syntaxe
Renvoie
Objet Date. Date et heure actuelles.
Exemple
L'exemple suivant retourne le nombre d'heures
entre la date et l'heure actuelles et Noël :
Cette fonction retourne un nombre compris entre 1 et 4
qui correspond au trimestre auquel appartient une date. Le premier trimestre commence le 1er janvier.
Syntaxe
Paramètre
date
Objet date d'obtention du trimestre.
Renvoie
Entier. Nombre de trimestres pour une date donnée.
Exemples
L'exemple suivant indique le nombre
de trimestres retourné pour des dates spécifiques :
L'exemple suivant retourne le numéro du
trimestre de chaque valeur dans la zone CloseDate :
L'exemple suivant retourne le numéro
du trimestre de la date en cours :
Cette fonction retourne la date en cours qui inclut la valeur temps minuit, par exemple, Feb 2, 2009 12:00 AM.
Syntaxe
Renvoie
Objet Date. Date en cours avec la valeur temps minuit.
Exemples
L'exemple suivant renvoie le nombre de jours entre la date en cours et Noël :
L'exemple
suivant calcule le nombre d'années entre la valeur figurant dans la zone de données
HireDate et la date en cours.
Cette fonction retourne un nombre compris
entre 1 et 52 qui correspond au numéro de la semaine d'une date.
Syntaxe
Paramètre
date
Objet date d'obtention du numéro de semaine.
Renvoie
Entier. Numéro de la semaine pour une date données.
Exemples
L'exemple suivant indique le nombre de semaines
retourné pour des dates spécifiques :
L'exemple suivant retourne le numéro de la semaine pour chaque valeur dans la zone CloseDate :
L'exemple suivant retourne le numéro de semaine
de la date en cours :
Cette fonction retourne le jour de la
semaine d'une date. Selon l'option que vous spécifiez, cette fonction retourne
le jour de la semaine sous la forme d'un nombre, le nom complet du jour ou le nom abrégé du jour. Le
nom du jour de la semaine est propre à l'environnement local.
Syntaxe
Paramètres
date
Objet date d'obtention du jour de la semaine.
option
Entier. Facultatif. Nombre qui représente
le format à retourner. Utilisez l'une des valeurs suivantes :
Si vous ne définissez pas
cet argument, la fonction utilise l'option 1 par défaut.
Renvoie
Chaîne. Jour de la semaine pour une date donnée.
Exemples
L'exemple suivant indique les valeurs jour
de semaine retournées pour une date donnée :
L'exemple suivant retourne le jour de la
semaine de la date en cours :
Cette fonction retourne la valeur année
à quatre chiffres d'une date. Par exemple, si la date est 19 janvier 2009,
la fonction retourne 2009.
Syntaxe
Paramètre
date
Objet date d'obtention de l'année.
Renvoie
Entier. Valeur d'année à quatre chiffres pour une date donnée.
Exemples
L'exemple suivant retourne l'année
de chaque valeur dans la zone HireDate :
L'exemple suivant retourne l'année de la date en cours :