DateAndTime.TimeSerial(Int32, Int32, Int32) Metod

Definition

Namnområde:
Microsoft.VisualBasic
Sammansättning:
Microsoft.VisualBasic.Core.dll
Sammansättning:
Microsoft.VisualBasic.dll
Källa:
DateAndTime.vb
Källa:
DateAndTime.vb
Källa:
DateAndTime.vb
Källa:
DateAndTime.vb
Källa:
DateAndTime.vb

Returnerar ett Date värde som representerar en angiven timme, minut och sekund, med datuminformationen angiven i förhållande till 1 januari i år 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

Parametrar

Hour
Int32

Required. Heltalsuttryck från 0 till 23. Värden utanför det här intervallet accepteras dock också.

Minute
Int32

Required. Heltalsuttryck från 0 till 59. Värden utanför det här intervallet accepteras dock också. Värdet Minute för läggs till i den beräknade timmen, så ett negativt värde anger minuter före den timmen.

Second
Int32

Required. Heltalsuttryck från 0 till 59. Värden utanför det här intervallet accepteras dock också. Värdet Second för läggs till i den beräknade minuten, så ett negativt värde anger sekunder före den minuten.

Returer

DateTime

Ett Date värde som representerar en angiven timme, minut och sekund, med datuminformationen angiven i förhållande till 1 januari i år 1.

Undantag

ArgumentException

Ett argument ligger utanför intervallet -2 147 483 648 till 2 147 483 647

ArgumentOutOfRangeException

Beräknad tid är mindre än negativa 24 timmar.

Exempel

I följande exempel används TimeSerial funktionen för att returnera en tid för den angivna timmen, minuten och sekunden.

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

Kommentarer

I följande exempel visas negativa, noll och positiva argumentvärden. Funktionen TimeSerial returnerar en tid som representerar 15 minuter före tre timmar före 12:00 eller 08:45:00.

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

Om antingen Minute eller Second överskrider sitt normala intervall tillämpas det på nästa större enhet efter behov. Om du till exempel anger 75 minuter beräknas det som en timme och 15 minuter.

TimeSerial minskar det totala antalet sekunder modulo 86,400, vilket är antalet sekunder på en dag. Därför är den returnerade tiden alltid mellan 00:00:00 och 23:59:59.

Datatypen Date innehåller datumkomponenter. TimeSerial anger alla dessa till 1, så det returnerade värdet representerar den första dagen i år 1. Men om argumentens värden leder till att den beräknade tiden överskrider 24 timmar ökas dagen efter behov. I följande exempel resulterar värdena Hour för och Minute i en kombinerad tid på mer än 24 timmar.

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

Om värdena för argumenten resulterar i en negativ beräknad tid anges datuminformationen till 1/1/0001 och tidsinformationen justeras till mellan 00:00:00 och 23:59:59. Men om den beräknade tiden är mindre än negativa 24 timmar uppstår ett ArgumentOutOfRangeException fel.

Eftersom varje Date värde stöds av en System.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