DateAndTime.TimeSerial(Int32, Int32, Int32) Yöntem

Tanım

Belirtilen saat, dakika ve saniye değerlerini temsil eden bir Date değer döndürür ve tarih bilgisi 1 Ocak 1'e göre ayarlanır.

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

Parametreler

Hour
Int32

Gereklidir. 0 ile 23 arasında tamsayı ifadesi. Ancak, bu aralığın dışında kalan değerler de kabul edilir.

Minute
Int32

Gereklidir. 0 ile 59 arasında tamsayı ifadesi. Ancak, bu aralığın dışında kalan değerler de kabul edilir. değeri Minute hesaplanan saate eklenir, bu nedenle negatif bir değer o saatten dakika öncesini belirtir.

Second
Int32

Gereklidir. 0 ile 59 arasında tamsayı ifadesi. Ancak, bu aralığın dışında kalan değerler de kabul edilir. değeri Second hesaplanan dakikaya eklenir, bu nedenle negatif bir değer o dakikadan saniye öncesini belirtir.

Döndürülenler

Date Belirtilen saat, dakika ve saniye değerlerini temsil eden ve tarih bilgisinin 1 Ocak'a göre ayarlandığı bir değer.

Özel durumlar

Bağımsız değişken -2.147.483.648 ile 2.147.483.647 arasında değildir

Hesaplanan süre negatif 24 saatten azdır.

Örnekler

Aşağıdaki örnek belirtilen saat, dakika ve saniye için bir saat döndürmek için işlevini kullanır TimeSerial .

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

Açıklamalar

Aşağıdaki örnekte negatif, sıfır ve pozitif bağımsız değişken değerleri gösterilmektedir. İşlev, TimeSerial öğlenden üç saat önce 15 dakikayı veya 8:45:00'ı temsil eden bir zaman döndürür.

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

Minute Normal aralığını aşıyor veya Second aşıyorsa, uygun şekilde bir sonraki daha büyük birime uygulanır. Örneğin, 75 dakika belirtirseniz, bir saat 15 dakika olarak değerlendirilir.

TimeSerial bir gündeki saniye sayısı olan toplam saniye modulo 86.400 sayısını azaltır. Bu nedenle, döndürülen süre her zaman 00:00:00 ile 23:59:59 arasındadır.

Veri Date türü tarih bileşenlerini içerir. TimeSerial bunların tümünü 1 olarak ayarlar, dolayısıyla döndürülen değer 1 yılının ilk gününü temsil eder. Ancak, bağımsız değişkenlerin değerleri hesaplanan sürenin 24 saati aşmasına neden olursa, gün gerektiği şekilde artırılır. Aşağıdaki örnekte ve Minute değerleri Hour 24 saatten uzun bir birleşik süreyle sonuçlanır.

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

Bağımsız değişkenlerin değerleri negatif hesaplanan saatle sonuçlanırsa, tarih bilgileri 1/1/0001 olarak ayarlanır ve zaman bilgileri 00:00:00 ile 23:59:59 arasında olacak şekilde ayarlanır. Ancak, hesaplanan süre negatif 24 saatten azsa bir ArgumentOutOfRangeException hata oluşur.

Her Date değer bir System.DateTime yapı tarafından desteklendiğinden, yöntemleri size bir Date değerin birleştirilmesinde ek seçenekler sağlar. Örneğin, istenen bileşen birleşimini kullanarak bir Date değişkeni doldurmak için aşırı yüklenmiş DateTime oluşturuculardan birini kullanabilirsiniz. Aşağıdaki örnek, sabahın 8:30'undan önce saniyenin onda birinde 6 Mayıs 1978 olarak ayarlar newDateTime :

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

Şunlara uygulanır

Ayrıca bkz.