DateAndTime.TimeSerial(Int32, Int32, Int32) Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic

Zestaw:

Microsoft.VisualBasic.Core.dll

Źródło:

DateAndTime.vb

Date Zwraca wartość reprezentującą określoną godzinę, minutę i sekundę z informacjami o dacie ustawionymi względem 1 stycznia roku 1.

public:
 static DateTime TimeSerial(int Hour, int Minute, int Second);

public static DateTime TimeSerial (int Hour, int Minute, int Second);

static member TimeSerial : int * int * int -> DateTime

Public Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTime

Parametry

Hour

Int32

Wymagane. Wyrażenie całkowite z zakresu od 0 do 23. Akceptowane są również wartości spoza tego zakresu.

Minute

Int32

Wymagane. Wyrażenie całkowite z zakresu od 0 do 59. Akceptowane są również wartości spoza tego zakresu. Wartość funkcji Minute jest dodawana do obliczonej godziny, więc wartość ujemna określa minuty przed godziną.

Second

Int32

Wymagane. Wyrażenie całkowite z zakresu od 0 do 59. Akceptowane są również wartości spoza tego zakresu. Wartość jest Second dodawana do minuty obliczeniowej, więc wartość ujemna określa sekundy przed minutą.

Zwraca

DateTime

Date Wartość reprezentująca określoną godzinę, minutę i sekundę z informacjami o dacie ustawionymi względem 1 stycznia roku 1.

Wyjątki

ArgumentException

Argument jest poza zakresem -2,147,483,648 do 2,147,483,647

ArgumentOutOfRangeException

Obliczony czas jest krótszy niż ujemny 24 godziny.

Przykłady

W poniższym przykładzie użyto TimeSerial funkcji , aby zwrócić czas dla określonej godziny, minuty i sekundy.

Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)

Uwagi

W poniższym przykładzie przedstawiono ujemne, zerowe i dodatnie wartości argumentów. Funkcja TimeSerial zwraca czas reprezentujący 15 minut przed trzema godzinami przed południem lub 8:45:00.

Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)  

W przypadku przekroczenia Minute normalnego zakresu lub Second zastosowania go do następnej większej jednostki zgodnie z potrzebami. Jeśli na przykład określisz 75 minut, zostanie ona obliczona jako jedna godzina i 15 minut.

TimeSerial zmniejsza łączną liczbę sekund modulo 86 400, czyli liczbę sekund w ciągu dnia. Dlatego zwracany czas jest zawsze z zakresu od 00:00:00 do 23:59:59.

Typ Date danych zawiera składniki daty. TimeSerial ustawia wszystkie te wartości na 1, więc zwrócona wartość reprezentuje pierwszy dzień roku 1. Jeśli jednak wartości argumentów powodują, że obliczony czas przekracza 24 godziny, dzień jest zwiększany w razie potrzeby. W poniższym przykładzie wartości Hour i Minute powodują łączny czas przekraczający 24 godziny.

MsgBox(TimeSerial(23, 75, 0))   
' The preceding statement displays "1/2/0001 12:15:00 AM".  

Jeśli wartości argumentów powodują ujemną godzinę obliczeniową, informacje o dacie są ustawione na 1/1/0001, a informacje o czasie są dostosowywane do zakresu od 00:00:00 do 23:59:59:59. Jeśli jednak obliczony czas jest krótszy niż ujemny 24 godziny, ArgumentOutOfRangeException wystąpi błąd.

Ponieważ każda Date wartość jest obsługiwana System.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ż

• DateSerial(Int32, Int32, Int32)
• DateValue(String)
• Hour(DateTime)
• Minute(DateTime)
• Now
• Second(DateTime)
• TimeValue(String)