DateAndTime.TimeSerial(Int32, Int32, Int32) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した時間、分、秒を表す Date 値を返します。日付情報は 1 年の 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 -> DateTimePublic 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の値は計算された分に加算されるため、負の値はその分の秒前に指定されます。
返品
指定した時間、分、秒を表す Date 値で、日付情報は 1 年の 1 月 1 日を基準に設定されます。
例外
引数が -2,147,483,648 ~ 2,147,483,647 の範囲外です
計算時間が負の 24 時間未満です。
例
次の例では、 TimeSerial 関数を使用して、指定した時間、分、秒の時刻を返します。
Dim thisTime As Date
thisTime = TimeSerial(16, 35, 17)
注釈
次の例では、負、ゼロ、正の引数の値を示します。
TimeSerial関数は、正午の 3 時間前の 15 分前、または午前 8 時 45 分を表す時刻を返します。
Dim alarmTime As Date = TimeSerial(12 - 3, -15, 0)
MinuteまたはSecondが通常の範囲を超えた場合は、必要に応じて次の大きな単位に適用されます。 たとえば、75 分を指定すると、1 時間 15 分として評価されます。
TimeSerial は、1 日の秒数である合計秒数剰余 86,400 を減らします。 したがって、返される時間は常に 00:00:00 から 23:59:59 の間です。
Dateデータ型には、日付コンポーネントが含まれます。
TimeSerial はこれらすべてを 1 に設定するため、戻り値は 1 年の最初の日を表します。 ただし、引数の値によって計算された時間が 24 時間を超える場合、日は必要に応じてインクリメントされます。 次の例では、 Hour と Minute の値の合計時間が 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 分の 1 秒の 1/10 に設定します。
Dim newDateTime As Date = New Date(1978, 5, 6, 8, 29, 59, 900)