Description
DatePart renvoie un nombre qui spécifie une partie donnée d'une date donnée.
Syntaxes des arguments
DatePart (typeIntervalle, dateHeureEntrée)
DatePart (typeIntervalle, dateHeureEntrée, premierJourSemaine)
DatePart (typeIntervalle, dateHeureEntrée, premierJourSemaine, premièreSemaineAnnée)
Arguments
"typeIntervalle" est une expression de chaîne qui spécifie la partie d'une date à renvoyer.
"dateHeureEntrée" est la valeur de type date/heure dont une partie sera extraite.
"premierJourSemaine" est une constante facultative utilisée pour spécifier le premier jour de la semaine. Si cet argument est omis, "crSunday" est utilisé par défaut.
"premièreSemaineAnnée" est une constante facultative qui spécifie la première semaine de l'année. Si cette constante est omise, la première semaine utilisée par défaut est celle incluant le 1er janvier (crFirstJan1).
Valeurs d'argument
Les valeurs possibles pour typeIntervalle sont les suivantes :
Valeur de type intervalle
| |
|---|
| |
| Trimestre (résultat = 1, 2, 3 ou 4)
|
| |
| Jour de l'année (de 1 à 365 ou 366 lorsque il s'agit une année bissextile)
|
| La partie jour de la date (1 à 31)
|
| Jour de la semaine (de 1 à 7, le résultat dépendant du jour choisi pour "premierJourSemaine")
|
| Semaine de l'année (de 1 à 53, avec "permierJourSemaine" et "premièreSemaineAnnée" pour déterminer les jours exacts de la première semaine de l'année civile)
|
| Extrait la partie horaire de la DateHeure donnée (de 0 à 23)
|
| Partie des minutes (de 0 à 59)
|
| Partie des secondes (de 0 à 59)
|
Action
DatePart renvoie un nombre qui spécifie une partie donnée d'une date donnée.
Exemples
DatePart ("d", #August 15, 1999#)Renvoie 15.
DatePart ("m", #August 15, 1999#)Renvoie 8.
DatePart ("n", #10:35 am#)Renvoie 35.
DatePart ("q", #September 29, 1999#)Renvoie 3 puisque le 29 septembre se situe dans le troisième trimestre de l'année.
DatePart ("ww", #September 14, 1997#)Renvoie 38 puisque le 14 septembre 1997 se situe dans la 38e semaine de 1997.
Supposons qu'une entreprise souhaite estampiller un numéro d'identification sur chacun de ses colis pour un contrôle de qualité. Le numéro d'identification est composé d'un numéro de commande suivi d'un tiret puis du numéro de la semaine où la commande a été envoyée et enfin par les deux derniers numéros de l'année. Exemple de formule générant ces ID :
CStr({Orders.Order ID}, 0, "") & "-" &
CStr(DatePart("ww", {Orders.Ship Date}), 0) &
CStr({Orders.Ship Date}, "yy")
Renvoie la chaîne "2082-3897" si {Commandes.ID de la commande} = 2082 et {Commandes.Date d'expédition} = 14 septembre 1997.
Commentaires
La fonction DatePart avec l'argument de type intervalle "yyyy" est égale à la fonction Year. De la même manière, la fonction DatePart avec les arguments de type intervalle "m", "d", "w", "h", "n" et "s" est identique aux fonctions Month, Day, Weekday (ou DayOfWeek), Hour, Minute et Second respectivement. Toutefois, il n'existe pas d'alternative simple pour utiliser la fonction DatePart avec les arguments de type intervalle "q", "y" et "ww".
L'argument "premierJourSemaine" affecte la fonction DatePart lorsque l'argument de type intervalle est "w" ou "ww". Pour toutes les autres valeurs d'argument "typeIntervalle", cet argument est ignoré.
L'argument "premièreSemaineAnnée" affecte la fonction DatePart uniquement lorsque l'argument intervalType est "ww". Pour toutes les autres valeurs d'argument "typeIntervalle", cet argument est ignoré.