DateSerial, fonction

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 présente les arguments suivantes :

Argument

Description

année

Obligatoire. Integer. Nombre compris entre 100 et 9999 inclus ou expression numérique.

mois

Obligatoire. Integer. Toute expression numérique.

jour

Obligatoire. Integer. Toute expression numérique.

Remarques

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

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

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

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

Les versions de Windows antérieures à Windows 2000 interprètent les années à deux chiffres sur la base 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.

Lorsque l’un des arguments dépasse la plage acceptée pour cet argument, il incrémente à l’unité plus grande suivante selon le cas. Par exemple, si vous spécifiez 35 jours, la période est d’un mois et d’un nombre de jours, selon l’année où elle est appliquée. Si un argument unique est en dehors de la plage -32 768 à 32 767, une erreur se produit. Si la date spécifiée par les trois arguments n’est pas dans la plage de dates acceptable, une erreur se produit.

Remarque : Pour l’année,le mois et le jour,si la définition de propriété Calendrier est grégorien, la valeur fournie est supposée être grégorien. Si le paramètre de la propriété Calendrier est Islamique (Hijri), la valeur fournie est supposée être le calendrier islamique (Hijri).

La partie date renvoyée est dans les unités de période du calendrier Visual Basic jour. Par exemple, si le calendrier actuel est islamique (Hijri) et que la partie date à retourner est l’année, la valeur de l’année est une année islamique (Hijri). Pour l’annéed’argument, les valeurs compris entre 0 et 99, incluses, sont interprétées comme étant les années 1400-1499. Pour toutes les autres valeurs d’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 » de l’année, du mois et du jour spécifiés entrés dans les arguments de la fonction et affiche dans la colonne « DateDate ». Résultat : « 12/13/2018 ».

Exemple de VBA

Remarque : Les exemples qui suivent illustrent l’utilisation de cette fonction dans un module Visual Basic pour Applications (VBA). Pour plus d’informations sur l’travail avec VBA, sélectionnez Référence du développeur dans la liste verte 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.

Voir aussi

Choisir la fonction de date correcte

Besoin d’aide ?

Développez vos compétences dans Office
Découvrez des formations
Accédez aux nouvelles fonctionnalités en avant-première
Rejoignez le programme Office Insider

Ces informations vous ont-elles été utiles ?

Nous vous remercions pour vos commentaires.

Merci pour vos commentaires. Il serait vraisemblablement utile pour vous de contacter l’un de nos agents du support Office.

×