DateSerial, fonction

Microsoft VBScript

Microsoft® Visual Basic® Scripting Edition DateSerial, fonction Référence du langage 
Version 1 

Voir aussi


Description
Renvoie un Variant de sous-type Date pour une année, un mois et un jour spécifiés.
Syntaxe
DateSerial(year, month, day)

La syntaxe de la fonction DateSerial comprend les éléments suivants:

Élément Description
year Nombre compris entre 100 et 9999 inclus, ou une expression numérique.
month Toute expression numérique.
day Toute expression numérique.

Notes
Pour spécifier une date telle que le 31 décembre 1991, la plage des nombres pour chaque argument DateSerial doit être normalement comprise dans la plage acceptée pour l'unité; autrement dit, 1–31 pour les jours et 1–12 pour les mois. Toutefois, vous pouvez aussi spécifier des dates relatives pour chaque argument en utilisant toute expression numérique représentant un certain nombre de jours, de mois ou d'années antérieurs ou postérieurs à une date donnée.

L'exemple suivant utilise des expressions numériques à la place des nombres absolus de date. Ici, la fonction DateSerial renvoie une date correspondant au jour précédant le premier jour (1 - 1), deux mois précédant le mois d'août (8 - 2), 10 ans avant 1990 (1990 - 10); en d'autres termes, le 31 mai 1980.

Dim MyDate1, MyDate2
MyDate1 = DateSerial(1970, 1, 1)			' Renvoie 1 janvier 1970.
MyDate2 = DateSerial(1990 - 10, 8 - 2, 1 - 1)	' Renvoie 31 mai 1980.
Pour l'argument year, les valeurs comprises entre 0 et 99 inclus sont interprétées comme les années 1900–1999. Pour tous les autres arguments year, utilisez une année complète à quatre chiffres (par exemple, 1800).

Quand tout argument excède la plage normalement acceptée pour cet argument, l'incrémentation s'effectue sur l'unité supérieure suivante qui convient. Par exemple, si vous spécifiez 35 jours, ils sont transformés en un mois et un certain nombre de jours, selon le moment de l'année auxquels ils s'appliquent. Toutefois, si un seul argument se situe hors de la plage -32 768 à 32 767, ou si la date spécifiée par les trois arguments, soit directement ou par expression, n'est pas comprise dans la plage acceptable des dates, une erreur se produit.