DateAndTime.DateSerial(Int32, Int32, Int32) Méthode

Définition

Retourne une Date valeur représentant l’année, le mois et le jour spécifiés, avec les informations d’heure définies sur minuit (00 :00 :00 :00).

public static DateTime DateSerial (int Year, int Month, int Day);

Paramètres

Year
Int32

Obligatoire. Expression entière comprise entre 1 et 9999. Toutefois, les valeurs inférieures à cette plage sont également acceptées. Si Year la valeur est comprise entre 0 et 99, elle est interprétée comme étant comprise entre 1930 et 2029, comme expliqué dans la section « Remarques ». Si Year est inférieure à 1, elle est soustraite de l'année actuelle.

Month
Int32

Obligatoire. Expression entière comprise entre 1 et 12. Cependant, les valeurs non comprises dans cette plage sont également acceptées. La valeur de Month est décalée de 1 et appliquée au mois de janvier de l'année calculée. En d'autres termes, (Month - 1) est ajouté à janvier. L'année est recalculée si nécessaire. Les résultats suivants illustrent cet effet :

Si Month a la valeur 1, le résultat est le mois de janvier de l'année calculée.

Si Month a la valeur 0, le résultat est décembre de l'année précédente.

Si Month a la valeur -1, le résultat est novembre de l'année précédente.

Si Month a la valeur 13, le résultat est le mois de janvier de l'année suivante.

Day
Int32

Obligatoire. Expression entière comprise entre 1 et 31. Cependant, les valeurs non comprises dans cette plage sont également acceptées. La valeur de Day est décalée de 1 et appliquée au premier jour du mois calculé. En d'autres termes, (Day - 1) est ajouté au premier du mois. Le mois et l'année sont recalculés si nécessaire. Les résultats suivants illustrent cet effet :

Si Day a la valeur 1, le résultat est le premier jour du mois calculé.

Si Day a la valeur 0, le résultat est le dernier jour du mois précédent.

Si Day a la valeur -1, le résultat est l'avant-dernier jour du mois précédent.

Si Day est ultérieur à la fin du mois en cours, le résultat est le jour correspondant du mois suivant. Par exemple, si Month a la valeur 4 et Day la valeur 31, le résultat est le 1er mai.

Retours

Valeur qui représente l’année, le mois et le jour spécifiés, avec les informations d’heure définies sur minuit (00 :00 :00 :00).

Exemples

Cet exemple utilise la DateSerial fonction pour retourner la date de l’année, du mois et du jour spécifiés.

' DateSerial returns the date for a specified year, month, and day.
Dim aDate As Date
' Variable aDate contains the date for February 12, 1969.
aDate = DateSerial(1969, 2, 12)
Console.WriteLine(aDate)

' The following example uses DateSerial to determine and display
' the last day of the previous month.
' First, establish a starting date.
Dim startDate = #1/23/1994#
' The 0 for the day represents the last day of the previous month.
Dim endOfLastMonth = DateSerial(startDate.Year, startDate.Month, 0)
Console.WriteLine("Last day in the previous month: " & endOfLastMonth)

' The following example finds and displays the day of the week that the 
' 15th day of the following month will fall on.
Dim fifteenthsDay = DateSerial(Today.Year, Today.Month + 1, 15)
Console.WriteLine("The 15th of next month is a {0}", fifteenthsDay.DayOfWeek)

Remarques

Les valeurs à 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 sont interprétées comme les années 2000-2029, et que les valeurs comprises entre 30 et 99 sont interprétées comme les années 1930-1999. Pour signifier toutes les autres années, utilisez une année à quatre chiffres, par exemple 1924.

L’exemple suivant illustre les valeurs d’argument négatives, nulles et positives. Ici, la DateSerial fonction retourne un Date représentant le jour précédant le premier jour de mars de l’année 10 ans avant l’année en cours ; en d’autres termes, le dernier jour de février il y a dix ans.

Dim EndFeb As Date = DateSerial(-10, 3, 0)  

Month Si ou Day dépasse sa plage normale, elle est appliquée à l’unité plus grande suivante, le cas échéant. Par exemple, si vous spécifiez 32 jours, il est évalué comme un mois et de 1 à quatre jours, en fonction de la valeur de Month. Si Year est supérieur à 9999 ou si un argument est en dehors de la plage -2 147 483 648 à 2 147 483 647, une ArgumentException erreur se produit. Si la date spécifiée par les trois arguments est antérieure à 00 :00 :00 le 1er janvier de l’année 1 ou postérieure à 23 :59 :59 :59 le 31 décembre 9999, une ArgumentOutOfRangeException erreur se produit.

Le Date type de données inclut des composants d’heure. DateSerial définit tous ces éléments sur 0, de sorte que la valeur retournée représente le début du jour calculé.

Étant donné que chaque Date valeur est prise en charge par une DateTime structure, ses méthodes vous offrent des options supplémentaires pour assembler une Date valeur. Par exemple, vous pouvez utiliser l’un des constructeurs surchargés DateTime pour remplir une Date variable à l’aide de la combinaison de composants souhaitée. L’exemple suivant définit NewDateTime le 6 mai 1978 à un dixième de seconde avant 8h30 du matin :

Dim NewDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)  

S’applique à

Produit Versions
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Voir aussi