DateAndTime.TimeSerial メソッド

.NET Framework クラス ライブラリ リファレンス

DateAndTime.TimeSerial メソッド

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

名前空間: Microsoft.VisualBasic
アセンブリ: Microsoft.VisualBasic (microsoft.visualbasic.dll 内)
構文

Visual Basic (宣言)

Public Shared Function TimeSerial
 ( _
    Hour As Integer, _
    Minute As Integer, _
    Second As Integer _
) As DateTime

Visual Basic (使用法)

Dim Hour As Integer
Dim Minute As Integer
Dim Second As Integer
Dim returnValue As DateTime

returnValue = DateAndTime.TimeSerial(Hour, Minute, Second)

C#

public static DateTime TimeSerial (
    int Hour,
    int Minute,
    int Second
)

C++

public:
static DateTime TimeSerial (
    int Hour, 
    int Minute, 
    int Second
)

J#

public static DateTime TimeSerial (
    int Hour, 
    int Minute, 
    int Second
)

JScript

public static function TimeSerial
 (
    Hour : int, 
    Minute : int, 
    Second : int
) : DateTime

パラメータ

Hour

必須。0 ～ 23 の整数型 (Integer) の式。ただし、この範囲外の値も受け入れられます。

Minute

必須。0 ～ 59 の整数型 (Integer) の式。ただし、この範囲外の値も受け入れられます。計算される時には Minute の値が加算されるため、負の値を指定するとその時からさかのぼる分数が指定されます。

Second

必須。0 ～ 59 の整数型 (Integer) の式。ただし、この範囲外の値も受け入れられます。算出される分には Second の値が加算されるため、負の値を指定するとその分からさかのぼる秒数が指定されます。

戻り値
1 年 1 月 1 日を基準に設定された日付情報を使用して、指定された時、分、秒を表す Date 値を返します。

解説

詳細については、Visual Basic のトピック「TimeSerial 関数 (Visual Basic)」を参照してください。

次の例では、引数に負の値、0、正の値を指定した場合の動作を示します。TimeSerial 関数は、正午から 3 時間 15 分前、つまり 8:45:00 AM を表す時刻を返します。

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

Minute または Second が通常の値の範囲を超えていた場合、次に大きな単位が適切に適用されます。たとえば 75 分を指定すると、1 時間 15 分と解釈されます。

TimeSerial では、86,400 (1 日の秒数) をモジュロとして秒の総数を約分します。したがって、返される時刻は常に 00:00:00 ～ 23:59:59 の範囲に収まります。

Date データ型には日付の要素が含まれています。TimeSerial では、このすべての要素が 1 に設定されるため、返される値は 1 年 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 エラーが発生します。

System.DateTime 構造体ではすべての Date 値がサポートされるため、メソッドでは Date 値の生成にその他のオプションを使用できます。たとえば、オーバーロードされた DateTime コンストラクタの 1 つを使用すると、目的の要素の組み合わせを使用して Date 変数に入力できます。次の例では、newDateTime を 1978 年 5 月 6 日午前 8:30 の 10 分の 1 秒前に設定します。

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

使用例

次に示す例では TimeSerial 関数を使用して、指定した時、分、秒に対応する時刻を返します。

Visual Basic

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DateAndTime クラス
DateAndTime メンバ
Microsoft.VisualBasic 名前空間
その他の技術情報
TimeSerial 関数 (Visual Basic)
DateSerial 関数 (Visual Basic)
DateValue 関数 (Visual Basic)
Hour 関数 (Visual Basic)
Minute 関数
Now プロパティ
Second 関数 (Visual Basic)
TimeValue 関数 (Visual Basic)