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

Tanım

DateBelirtilen saat, dakika ve saniyeyi temsil eden bir değer döndürür ve Tarih bilgisi 1 yılının 1 Ocak ayına göre ayarlanır.Returns a Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 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

Parametreler

Hour
Int32

Gereklidir.Required. 0 ile 23 arasında bir tamsayı ifadesi.Integer expression from 0 through 23. Ancak, bu aralığın dışında kalan değerler de kabul edilir.However, values outside this range are also accepted.

Minute
Int32

Gereklidir.Required. 0 ile 59 arasında tamsayı ifadesi.Integer expression from 0 through 59. Ancak, bu aralığın dışında kalan değerler de kabul edilir.However, values outside this range are also accepted. Değeri Minute hesaplanmış saate eklenir, bu nedenle negatif bir değer bu saatten önceki dakikaları belirtir.The value of Minute is added to the calculated hour, so a negative value specifies minutes before that hour.

Second
Int32

Gereklidir.Required. 0 ile 59 arasında tamsayı ifadesi.Integer expression from 0 through 59. Ancak, bu aralığın dışında kalan değerler de kabul edilir.However, values outside this range are also accepted. Değeri Second hesaplanmış dakikaya eklenir, bu nedenle negatif bir değer bu dakika öncesine saniye değerini belirtir.The value of Second is added to the calculated minute, so a negative value specifies seconds before that minute.

Döndürülenler

DateTime

DateBelirtilen saat, dakika ve saniyeyi temsil eden, tarih bilgisi 1 yılının 1 Ocak ayına göre ayarlanmış bir değer.A Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 1.

Özel durumlar

Bağımsız değişken 2.147.483.648 ile 2.147.483.647 arasında bir bağımsız değişken dışındaAn argument is outside the range -2,147,483,648 through 2,147,483,647

Hesaplanan saat negatif 24 saatten daha az.Calculated time is less than negative 24 hours.

Örnekler

Aşağıdaki örnek, TimeSerial belirtilen saat, dakika ve saniye için bir zaman döndürmek üzere işlevini kullanır.The following example uses the TimeSerial function to return a time for the specified hour, minute, and second.

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

Açıklamalar

Aşağıdaki örnek negatif, sıfır ve pozitif bağımsız değişken değerlerini gösterir.The following example demonstrates negative, zero, and positive argument values. TimeSerialİşlev, öğleden önce üç saatten önce 15 dakikayı temsil eden bir süre veya 8:45:00 ' i döndürür.The TimeSerial function returns a time representing 15 minutes before three hours before noon, or 8:45:00 AM.

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

Ya da Minute Second kendi normal aralığını aşarsa, uygun şekilde bir sonraki daha büyük birime uygulanır.If either Minute or Second exceeds its normal range, it is applied to the next larger unit as appropriate. Örneğin, 75 dakika belirtirseniz, bir saat ve 15 dakika olarak değerlendirilir.For example, if you specify 75 minutes, it is evaluated as one hour and 15 minutes.

TimeSerial bir gündeki saniye sayısı olan toplam saniye modül 86.400 değerini azaltır.TimeSerial reduces the total seconds modulo 86,400, which is the number of seconds in a day. Bu nedenle, döndürülen süre her zaman 00:00:00 ile 23:59:59 arasındadır.Therefore, the returned time is always between 00:00:00 and 23:59:59.

DateVeri türü tarih bileşenlerini içerir.The Date data type includes date components. TimeSerial Bunların tümünü 1 olarak ayarlar, bu nedenle döndürülen değer 1 yılının ilk gününü temsil eder.TimeSerial sets all of these to 1, so the returned value represents the first day of the year 1. Ancak, bağımsız değişkenlerin değerleri hesaplanan sürenin 24 saati aşmasına neden olursa, gün gereken şekilde artırılır.However, if the values of the arguments cause the calculated time to exceed 24 hours, the day is incremented as necessary. Aşağıdaki örnekte, değerleri, Hour Minute 24 saatten uzun bir süre boyunca Birleşik bir süre ile sonuçlanır.In the following example, the values of Hour and Minute result in a combined time of more than 24 hours.

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 bir hesaplanan süre ile sonuçlanıyorsa, tarih bilgileri 1/1/0001 olarak ayarlanır ve zaman bilgileri 00:00:00 ile 23:59:59 arasında ayarlanır.If the values of the arguments result in a negative calculated time, the date information is set to 1/1/0001 and the time information is adjusted to be between 00:00:00 and 23:59:59. Ancak, hesaplanan saat negatif 24 saatten azsa bir ArgumentOutOfRangeException hata oluşur.However, if the calculated time is less than negative 24 hours, an ArgumentOutOfRangeException error occurs.

Her Date değer bir yapı tarafından desteklendiğinden System.DateTime , yöntemleri bir değer montajı konusunda ek seçenekler sağlar Date .Since every Date value is supported by a System.DateTime structure, its methods give you additional options in assembling a Date value. Örneğin, DateTime Date istenen bileşen birleşimini kullanarak bir değişkeni doldurmak için aşırı yüklenmiş oluşturuculardan birini kullanabilirsiniz.For example, you can employ one of the overloaded DateTime constructors to populate a Date variable using the desired combination of components. Aşağıdaki örnek, newDateTime sabah 8:30 ' de 6 mayıs 1978 ' e kadar bir saniyenin 5 ' i olarak ayarlanır:The following example sets newDateTime to May 6, 1978 at one tenth of a second before 8:30 in the morning:

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

Şunlara uygulanır

Ayrıca bkz.