Fonction DateSerial

  • Article

Renvoie une Variant (Date) pour une année, un mois et un jour spécifique.

Syntaxe

DateSerial(year, month, day)

La syntaxe de la fonction DateSerial comprend les arguments nommés suivants :

Élément Description
year Obligatoire ; Entier. Nombre compris entre 100 et 9999, inclus, ou une expression numérique.
mois Obligatoire ; Entier. Expression numérique.
day Obligatoire ; Entier. Toute expression numérique.

Remarques

Pour spécifier une date, telle que le 31 décembre 1991, la plage de nombres de chaque argumentDateSerial 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 de toute expression numérique qui représente un nombre de jours, mois ou années avant ou après une date donnée.

L’exemple suivant utilise des expressions numériques au lieu de nombres de date absolus. Ici la fonction SérieDate renvoie une date qui correspond au jour avant le premier jour (1 - 1), deux mois avant août (8 - 2), 10 ans avant 1990 (1990 - 10) ; en d’autres termes, le 31 mai 1980.

Sous Windows 98 ou Windows 2000, les années à deux chiffres pour l’argumentannée sont interprétées en fonction des paramètres définis par l’utilisateur sur son ordinateur. Les paramètres par défaut, qui sont les valeurs comprises entre 0 et 29, inclus, sont interprétées en tant qu'années 2000 à 2029. Les valeurs par défaut comprises entre 30 et 99 sont interprétées en tant qu'années 1930 à 1999. Pour tous les autres arguments année, utilisez une année à quatre chiffres (par exemple, 1800).

Les versions antérieures de Windows interprètent les années à deux chiffres basées sur les paramètres par défaut décrits précédemment. Pour être sûr que la fonction renvoie la valeur appropriée, utilisez une année à quatre chiffres.

Lorsqu'un argument excède la plage acceptée, il est incrémenté à l'unité supérieure suivante. Par exemple, si vous spécifiez 35 jours, l'argument est évalué en tant que mois et un certain nombre de jours, en fonction du moment de l'année où il est appliqué. Si un seul argument est hors de la plage comprise entre -32 768 à 32,767, une erreur se produit. Si la date spécifiée par les trois arguments se trouve hors de la plage de dates acceptables, une erreur se produit.

Remarque

Pour année, mois, et jour, si le paramètre de la propriété Calendrier est grégorien, la valeur fournie est supposée grégorienne. Si le paramètre de la propriétéCalendrier est Hijri, la valeur fournie est supposée Hijri.

La partie date renvoyée est exprimée en unités de la période de temps du calendrier Visual Basic actif. Par exemple, si le calendrier actif est Hijri et la partie date à renvoyer est l'année, la valeur de l'argument year 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 année, utilisez une année à quatre chiffres (par exemple, 1520).

Exemple

Cet exemple utilise la fonction DateSerial pour renvoyer la date pour l'année, le mois et le jour spécifiés.

Dim MyDate
' MyDate contains the date for February 12, 1969.
MyDate = DateSerial(1969, 2, 12)    ' Return a date.

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.