DateAndTime.TimeSerial(Int32, Int32, Int32) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca wartość reprezentującą Date 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 -> DateTimePublic Function TimeSerial (Hour As Integer, Minute As Integer, Second As Integer) As DateTimeParametry
- Hour
- Int32
To jest wymagane. Wyrażenie całkowite z zakresu od 0 do 23. Jednak wartości poza tym zakresem są również akceptowane.
- Minute
- Int32
To jest wymagane. Wyrażenie całkowite z zakresu od 0 do 59. Jednak wartości poza tym zakresem są również akceptowane. Wartość parametru Minute jest dodawana do obliczonej godziny, więc wartość ujemna określa minuty przed tym godziną.
- Second
- Int32
To jest wymagane. Wyrażenie całkowite z zakresu od 0 do 59. Jednak wartości poza tym zakresem są również akceptowane. Wartość parametru Second jest dodawana do minuty obliczeniowej, więc wartość ujemna określa sekundy przed minutą.
Zwraca
Date Wartość reprezentująca określoną godzinę, minutę i sekundę z informacjami o dacie ustawionymi względem 1 stycznia roku 1.
Wyjątki
Argument znajduje się poza zakresem -2,147,483,648 do 2,147,483,647
Obliczony czas jest krótszy niż ujemny 24 godziny.
Przykłady
W poniższym przykładzie użyto TimeSerial funkcji do zwrócenia czasu dla określonej godziny, minuty i sekundy.
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
Uwagi
W poniższym przykładzie przedstawiono wartości ujemnych, zero i dodatnich 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)
Jeśli wartość lub MinuteSecond przekroczy normalny zakres, zostanie ona zastosowana do następnej większej jednostki zgodnie z potrzebami. Jeśli na przykład zostanie określona wartość 75 minut, zostanie ona oceniona jako 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. 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 w montażu 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. o jednej dziesiątej sekundy przed godziną 8:30 rano:
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)