DateSerial, fonction

Renvoie une donnée de type Variante (Date) pour une année, un mois ou un jour.

Syntaxe

DateSerial ( year, month, day )

Avertissement    Vérifiez que les arguments se trouvent dans la plage de valeurs correcte. Un argument non valide peut entraîner un résultat incorrect.

La syntaxe de la fonction DateSerial contient les arguments suivants :

Notes

Pour spécifier une date, telle que le 31 décembre 1991, la plage de nombres de chaqueargumentDateSerial doit se trouver dans la plage acceptée pour l’unité ; c’est-à-dire 1 à 31 pour les jours et 1 à 12 pour les mois. Toutefois, vous pouvez également spécifier des dates relatives pour chaque argument à l’aide d’une expression numérique qui représente un certain nombre de jours, de mois ou d’années avant ou après une certaine date.

L’exemple suivant utilise des expressions numériques au lieu des numéros de date absolus. Ici, la fonction DateSerial retourne une date qui est le jour précédant le premier jour (1 - 1), deux mois avant août (8 - 2), 10 ans avant 1990 (1990 - 10) ; autrement dit, le 31 mai 1980.

DateSerial(1990 - 10, 8 - 2, 1 - 1)

Les années à deux chiffres de l’argument year sont interprétées en fonction des paramètres de l’ordinateur définis par l’utilisateur. Les paramètres par défaut sont que les valeurs comprises entre 0 et 29, inclus, sont interprétées comme les années 2000 à 2029. Les valeurs par défaut comprises entre 30 et 99 sont interprétées comme les années 1930-1999. Pour tous les autres arguments year , utilisez une année à quatre chiffres (par exemple, 1800).

Les versions de Windows antérieures à Windows 2000 interprètent les années à deux chiffres en fonction des valeurs par défaut décrites ci-dessus. Pour vous assurer que la fonction retourne la valeur appropriée, utilisez une année à quatre chiffres.

Lorsqu’un argument dépasse la plage acceptée pour cet argument, il est incrémenté à l’unité supérieure suivante, comme il convient. Par exemple, si vous spécifiez 35 jours, il est évalué comme un mois et un certain nombre de jours, en fonction de l’endroit dans l’année où il est appliqué. Si un seul argument se trouve en dehors de la plage -32 768 à 32 767, une erreur se produit. Si la date spécifiée par les trois arguments se trouve en dehors de la plage de dates acceptable, une erreur se produit.

La partie date retournée se trouve dans les unités de période du calendrier Visual Basic actuel. Par exemple, si le calendrier actuel est Hijri et que la partie date à retourner est l’année, la valeur de l’année est une année Hijri. Pour l’argument year, les valeurs comprises entre 0 et 99, inclusivement, sont interprétées comme les années 1400-1499. Pour toutes les autres valeurs d’année , utilisez l’année complète à quatre chiffres (par exemple, 1520).