DateAndTime.DateSerial(Int32, Int32, Int32) Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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);
public static DateTime DateSerial (int Year, int Month, int Day);
static member DateSerial : int * int * int -> DateTime
Public Function DateSerial (Year As Integer, Month As Integer, Day As Integer) As DateTime
- 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.
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).
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)
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)
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 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :