DateAndTime.TimeSerial(Int32, Int32, Int32) メソッド

定義

1 年 1 月 1 日を基準に設定された日付情報を使用して、指定された時、分、秒を表す Date 値を返します。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

パラメーター

Hour
Int32

必須です。Required. 0 から 23 の整数式。Integer expression from 0 through 23. ただし、この範囲外の値も受け入れられます。However, values outside this range are also accepted.

Minute
Int32

必須です。Required. 0 から 59 の整数式。Integer expression from 0 through 59. ただし、この範囲外の値も受け入れられます。However, values outside this range are also accepted. 計算される時には Minute の値が加算されるため、負の値を指定するとその時からさかのぼる分数が指定されます。The value of Minute is added to the calculated hour, so a negative value specifies minutes before that hour.

Second
Int32

必須です。Required. 0 から 59 の整数式。Integer expression from 0 through 59. ただし、この範囲外の値も受け入れられます。However, values outside this range are also accepted. 算出される分には Second の値が加算されるため、負の値を指定するとその分からさかのぼる秒数が指定されます。The value of Second is added to the calculated minute, so a negative value specifies seconds before that minute.

戻り値

DateTime

1 年 1 月 1 日を基準に設定された日付情報を使用して、指定された時、分、秒を表す Date 値。A Date value representing a specified hour, minute, and second, with the date information set relative to January 1 of the year 1.

例外

引数が -2,147,483,648 ~ 2,147,483,647 の範囲外です。An argument is outside the range -2,147,483,648 through 2,147,483,647

計算された時刻が負の 24 時間より小さくなっています。Calculated time is less than negative 24 hours.

次の例では、関数を使用して、 TimeSerial 指定した時間、分、および秒の時刻を返します。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)

注釈

次の例では、負の値、ゼロ、および正の引数の値を示します。The following example demonstrates negative, zero, and positive argument values. 関数は、 TimeSerial 正午から3時間前の15分前、または午前8:45:00 時を表す時刻を返します。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)  

またはのいずれかが通常の範囲を超えている場合は、必要に応じ Minute Second て次の大きな単位に適用されます。If either Minute or Second exceeds its normal range, it is applied to the next larger unit as appropriate. たとえば、75分を指定した場合、1時間15分として評価されます。For example, if you specify 75 minutes, it is evaluated as one hour and 15 minutes.

TimeSerial 秒の合計86400秒数を減らします (秒単位)。TimeSerial reduces the total seconds modulo 86,400, which is the number of seconds in a day. したがって、返される時刻は常に 00:00:00 ~ 23:59:59 です。Therefore, the returned time is always between 00:00:00 and 23:59:59.

データ型には、 Date 日付部分が含まれます。The Date data type includes date components. TimeSerial これらのすべてを1に設定するため、戻り値は1年の最初の日を表します。TimeSerial sets all of these to 1, so the returned value represents the first day of the year 1. ただし、引数の値によって計算された時間が24時間を超えた場合、その日は必要に応じてインクリメントされます。However, if the values of the arguments cause the calculated time to exceed 24 hours, the day is incremented as necessary. 次の例では、との値によって、 Hour Minute 合計24時間を超える時間が計算されます。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".  

引数の値が負の計算時間になると、日付情報は1/1/0001 に設定され、時刻情報は00:00:00 と23:59:59 の間に調整されます。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. ただし、計算された時間が負の24時間未満の場合は、 ArgumentOutOfRangeException エラーが発生します。However, if the calculated time is less than negative 24 hours, an ArgumentOutOfRangeException error occurs.

すべての Date 値は構造体によってサポートされるため System.DateTime 、値をアセンブルするときに、そのメソッドによって追加のオプションが提供され Date ます。Since every Date value is supported by a System.DateTime structure, its methods give you additional options in assembling a Date value. たとえば、オーバーロードされたコンストラクターのいずれかを DateTime 使用して、必要な Date コンポーネントの組み合わせを使用して変数を設定できます。For example, you can employ one of the overloaded DateTime constructors to populate a Date variable using the desired combination of components. 次の例では、 newDateTime 1978 年5月 6 8:30 秒に設定します。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)  

適用対象

こちらもご覧ください