DateAndTime.DateSerial(Int32, Int32, Int32) Metod

Definition

Namnområde:
Microsoft.VisualBasic
Sammansättning:
Microsoft.VisualBasic.dll

Returnerar ett Date värde som representerar det angivna året, månaden och dagen, med tidsinformationen inställd på midnatt (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

Parametrar

Year
Int32

Required. Heltalsuttryck från 1 till 9999. Värden under det här intervallet accepteras dock också. Om Year är 0 till 99 tolkas det som mellan 1930 och 2029, enligt beskrivningen i avsnittet "Anmärkningar". Om Year är mindre än 1 subtraheras den från det aktuella året.

Month
Int32

Required. Heltalsuttryck från 1 till 12. Värden utanför det här intervallet accepteras dock också. Värdet för Month är förskjutet med 1 och tillämpas på januari för det beräknade året. Med andra ord läggs (Month - 1) till i januari. Året beräknas om vid behov. Följande resultat illustrerar den här effekten:

Om Month är 1 är resultatet januari för det beräknade året.

Om Month är 0 är resultatet december föregående år.

Om Month är -1 är resultatet november föregående år.

Om Month är 13 blir resultatet januari följande år.

Day
Int32

Required. Heltalsuttryck från 1 till 31. Värden utanför det här intervallet accepteras dock också. Värdet Day för är förskjutet med 1 och tillämpas på den första dagen i den beräknade månaden. Med andra ord läggs (Day - 1) till den första i månaden. Månad och år beräknas om vid behov. Följande resultat illustrerar den här effekten:

Om Day är 1 blir resultatet den första dagen i den beräknade månaden.

Om Day är 0 blir resultatet den sista dagen i föregående månad.

Om Day är -1 är resultatet den näst sista dagen i föregående månad.

Om Day är efter slutet av den aktuella månaden är resultatet lämplig dag i följande månad. Om till exempel Month är 4 och Day är 31 blir resultatet 1 maj.

Returer

DateTime

Ett värde som representerar det angivna året, månaden och dagen, med tidsinformationen inställd på midnatt (00:00:00).

Exempel

I det DateSerial här exemplet används funktionen för att returnera datumet för det angivna året, månaden och dagen.

' 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)

Kommentarer

Tvåsiffriga värden för Year argumentet tolkas baserat på användardefinierade datorinställningar. Standardinställningarna är att värden från 0 till 29 tolkas som åren 2000–2029, och värden från 30 till 99 tolkas som åren 1930-1999. Om du vill ange alla andra år använder du ett fyrsiffrigt år, till exempel 1924.

I följande exempel visas negativa, noll och positiva argumentvärden. DateSerial Här returnerar funktionen en Date som representerar dagen före den första dagen i mars år 10 år före innevarande år, med andra ord den sista dagen i februari för tio år sedan.

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

Om antingen Month eller Day överskrider sitt normala intervall tillämpas det på nästa större enhet efter behov. Om du till exempel anger 32 dagar utvärderas den som en månad och från en till fyra dagar, beroende på värdet för Month. Om Year är större än 9999 eller om något argument ligger utanför intervallet -2 147 483 648 till 2 147 483 647 uppstår ett ArgumentException fel. Om datumet som anges av de tre argumenten är tidigare än 00:00:00 den 1 januari år 1 eller senare än 23:59:59 den 31 december 9999 uppstår ett ArgumentOutOfRangeException fel.

Datatypen Date innehåller tidskomponenter. DateSerial anger alla dessa till 0, så det returnerade värdet representerar början av den beräknade dagen.

Eftersom varje Date värde stöds av en DateTime struktur ger dess metoder ytterligare alternativ för att montera ett Date värde. Du kan till exempel använda en av de överlagrade DateTime konstruktörerna för att fylla i en Date variabel med hjälp av den önskade kombinationen av komponenter. I följande exempel anges NewDateTime till 6 maj 1978 på en tiondel av en sekund före 8:30 på morgonen:

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

Gäller för

Se även