DateAndTime.TimeSerial(Int32, Int32, Int32) 方法

定義

命名空間:
Microsoft.VisualBasic
組件:
Microsoft.VisualBasic.dll

回傳 Date 一個代表指定時、分鐘、秒的值，日期資訊相對於第一年1月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

參數

Hour
Int32

必須的。 整數表達式從0到23。 然而，超出此範圍的數值也被接受。

Minute
Int32

必須的。 整數表達式從0到59。 然而，超出此範圍的數值也被接受。 將 的 Minute 值加到計算出的小時上，因此負值表示該小時前的分鐘數。

Second
Int32

必須的。 整數表達式從0到59。 然而，超出此範圍的數值也被接受。 的值 Second 會加到計算出的分鐘數上，因此負值表示該分鐘前的幾秒。

傳回

DateTime

一個 Date 代表特定小時、分鐘和秒的值，日期資訊相對於第1年1月1日。

例外狀況

ArgumentException

一個參數超出了 -2,147,483,648 到 2,147,483,647 的範圍

ArgumentOutOfRangeException

計算時間少於負24小時。

範例

以下範例使用 TimeSerial 函式回傳指定的整點、分鐘和秒的時間。

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

備註

以下範例展示了負、零和正的參數值。 函數回 TimeSerial 傳的時間，代表中午前三小時前15分鐘，也就是上午8：45：00。

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

若任一 Minute 或 Second 超過正常範圍，則會依適當方式套用到下一個較大的單位。 例如，如果你指定75分鐘，它會被評估為1小時15分鐘。

TimeSerial 總秒數以 86,400 模減，也就是一天的秒數。 因此，回傳時間總是在00：00：00到23：59：59之間。

資料型別 Date 包含日期成分。 TimeSerial 將這些值全部設為 1，因此回傳的值代表第 1 年的第一天。 然而，若參數值導致計算時間超過24小時，則會根據需要增加該天。 以下範例中，和 Minute 的Hour值合計時間超過24小時。

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

若參數值計算時間為負，日期資訊設為 1/1/0001，時間資訊調整為 00：00：00 至 23：59：59。 然而，若計算時間少於負24小時， ArgumentOutOfRangeException 則會產生誤差。

由於每個 Date 值都有 System.DateTime 結構支撐，其方法為組合值提供了更多選項 Date 。 例如，你可以使用其中一個超 DateTime 載的建構子，用想要的組件組合來填充 Date 變數。 以下範例設定 newDateTime 在1978年5月6日上午8：30前0.0秒：

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

適用於

另請參閱