Renvoie une donnée de type Variante (Date) pour une année, un mois ou un jour.
Syntaxe
DateSerial(année, mois, jour)
Avertissement Assurez-vous que les arguments sont 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 :
| Argument | Description |
|---|---|
| année | Obligatoire. Entier. Nombre compris entre 100 et 9999 inclus ou expression numérique. |
| mois | Obligatoire. Entier. Toute expression numérique. |
| jour | Obligatoire. Entier. Toute expression numérique. |
Remarques
Pour spécifier une date, telle que le 31 décembre 1991, la plage de nombres pour chaque argument DateSerial doit être dans la plage acceptée pour l’unité ; c’est-à-dire 1 à 31 pour les jours et 1 à 12 pour les mois. Cependant, 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 de nombres de date absolus. Ici, la fonction DateSerial renvoie 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) ; en d’autres termes, le 31 mai 1980.
DateSerial(1990 - 10, 8 - 2, 1 - 1)
Les années à deux chiffres pour 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 d’année , utilisez une année à quatre chiffres (par exemple, 1800).
Les versions 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 renvoie la valeur appropriée, utilisez une année à quatre chiffres.
Lorsqu’un argument dépasse la plage acceptée pour cet argument, il incrémente vers l’unité plus grande suivante selon les besoins. Par exemple, si vous spécifiez 35 jours, il est évalué comme un mois et un certain nombre de jours, selon l’endroit de l’année où il est appliqué. Si un seul argument est en dehors de la plage comprise entre 32 768 et 32 767, une erreur se produit. Si la date spécifiée par les trois arguments est en dehors de la plage de dates acceptable, une erreur se produit.
Remarque
Pour année,mois et jour, si le paramètre de propriété Calendar est grégorien, la valeur fournie est supposée être grégorienne. Si le paramètre de la propriété Calendar est Hijri, la valeur fournie est supposée être Hijri.
La partie de date renvoyée est indiquée dans les unités de période du calendrier Visual Basic actuel. Par exemple, si le calendrier en cours est de l’Hégiri et que la partie de date à renvoyer est l’année, la valeur de l’année est une année de l’Hégire. Pour l’argument année, les valeurs comprises entre 0 et 99, inclus, sont interprétées comme les années 1400-1499. Pour toutes les autres valeurs de l’année , utilisez l’année complète à quatre chiffres (par exemple, 1520).
Exemple de requête
| Expression | Résultats |
|---|---|
| SELECT Dateserial(2018,12,13) AS NewDate FROM ProductSales ; | Renvoie la « date » pour l’année, le mois et le jour spécifiés entrés dans les arguments de la fonction et affiche dans la colonne « NewDate ». Résultat : « 13/12/2018 ». |
Exemple de VBA
Remarque
Les exemples suivants illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’utilisation de VBA, sélectionnez Référence développeur dans la liste déroulante en regard de Rechercher , puis entrez un ou plusieurs termes dans la zone de recherche.
Cet exemple utilise la fonction DateSerial pour renvoyer la date de l’année, du mois et du jour spécifiés.
Dim MyDate ' MyDate contains the date for February 12, 1969. MyDate = DateSerial(1969, 2, 12) ' Return a date.