DateAndTime.DateSerial(Int32, Int32, Int32) Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

DateAndTime.vb

Zwraca wartość reprezentującą Date określony rok, miesiąc i dzień z informacjami o czasie ustawionym na północ (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

Parametry

Year

Int32

Wymagane. Wyrażenie całkowite z zakresu od 1 do 9999. Jednak wartości poniżej tego zakresu również są akceptowane. Jeśli Year wartość wynosi od 0 do 99, jest interpretowana jako będąca w latach 1930-2029, jak wyjaśniono w sekcji "Uwagi". Jeśli Year wartość jest mniejsza niż 1, jest odejmowana od bieżącego roku.

Month

Int32

Wymagane. Wyrażenie całkowite z zakresu od 1 do 12. Akceptowane są również wartości spoza tego zakresu. Wartość Month jest przesunięty o 1 i stosowany do stycznia roku obliczeniowego. Innymi słowy, (Month - 1) jest dodawany do stycznia. Rok jest ponownie obliczany w razie potrzeby. Następujące wyniki ilustrują ten efekt:

Jeśli Month wartość to 1, wynikiem jest styczeń obliczonego roku.

Jeśli Month wartość wynosi 0, wynikiem jest grudzień poprzedniego roku.

Jeśli Month wartość to -1, wynikiem jest listopad poprzedniego roku.

Jeśli Month wartość wynosi 13, wynik wynosi styczeń następnego roku.

Day

Int32

Wymagane. Wyrażenie całkowite z zakresu od 1 do 31. Akceptowane są również wartości spoza tego zakresu. Wartość Day jest przesunięty o 1 i stosowany do pierwszego dnia obliczonego miesiąca. Innymi słowy, (Day - 1) jest dodawany do pierwszego miesiąca. Miesiąc i rok są ponownie obliczane w razie potrzeby. Następujące wyniki ilustrują ten efekt:

Jeśli Day wartość to 1, wynikiem jest pierwszy dzień obliczonego miesiąca.

Jeśli Day wartość to 0, wynikiem jest ostatni dzień poprzedniego miesiąca.

Jeśli Day wartość to -1, wynikiem jest przedostatni dzień poprzedniego miesiąca.

Jeśli Day minie koniec bieżącego miesiąca, wynikiem jest odpowiedni dzień następnego miesiąca. Na przykład jeśli Month wartość to 4 i Day ma wartość 31, wynikiem jest 1 maja.

Zwraca

DateTime

Wartość reprezentująca określony rok, miesiąc i dzień z informacjami o czasie ustawionym na północ (00:00:00).

Przykłady

W tym przykładzie użyto DateSerial funkcji , aby zwrócić datę dla określonego roku, miesiąca i dnia.

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

Uwagi

Dwie cyfry argumentu Year są interpretowane na podstawie ustawień komputera zdefiniowanych przez użytkownika. Ustawienia domyślne to wartości z zakresu od 0 do 29 są interpretowane jako lata 2000–2029, a wartości z zakresu od 30 do 99 są interpretowane jako lata 1930–1999. Aby oznaczać wszystkie pozostałe lata, użyj czterocyfrowego roku, na przykład 1924.

W poniższym przykładzie przedstawiono ujemne, zerowe i dodatnie wartości argumentów. DateSerial W tym miejscu funkcja zwraca wartość reprezentującą Date dzień przed pierwszym dniem marca w roku 10 lat przed bieżącym rokiem, innymi słowy, ostatnim dniem lutego dziesięć lat temu.

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

W przypadku przekroczenia Month normalnego zakresu lub Day zastosowania go do następnej większej jednostki zgodnie z potrzebami. Jeśli na przykład określisz 32 dni, zostanie ona obliczona jako miesiąc i z jednego do czterech dni, w zależności od wartości Month. Jeśli Year wartość jest większa niż 9999 lub jeśli jakikolwiek argument znajduje się poza zakresem -2 147 483 648 do 2 147 483 647, ArgumentException wystąpi błąd. Jeśli data określona przez trzy argumenty jest wcześniejsza niż 00:00:00 w dniu 1 stycznia roku 1 lub nowsza niż 23:59:59 w dniu 31 grudnia 9999 r., ArgumentOutOfRangeException wystąpi błąd.

Typ Date danych zawiera składniki czasu. DateSerial ustawia wszystkie te wartości na 0, więc zwrócona wartość reprezentuje początek dnia obliczeniowego.

Ponieważ każda Date wartość jest obsługiwana DateTime przez strukturę, jej metody zapewniają dodatkowe opcje tworzenia Date wartości. Na przykład można użyć jednego z przeciążonych DateTime konstruktorów, aby wypełnić zmienną Date przy użyciu żądanej kombinacji składników. W poniższym przykładzie ustawiono NewDateTime wartość 6 maja 1978 r. na jedną dziesiątą sekundy przed godziną 8:30 rano:

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

Zobacz też

• DateValue(String)
• Day(DateTime)
• Month(DateTime)
• Now
• TimeSerial(Int32, Int32, Int32)
• TimeValue(String)
• Weekday(DateTime, FirstDayOfWeek)
• Year(DateTime)
• System
• Typ danych — Podsumowanie (Visual Basic)