DateAndTime.DateSerial メソッド

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

DateAndTime.DateSerial メソッド

指定された年、月、日を表す Date 値を返します。時刻情報は午前 0 時 (00:00:00) に設定されます。

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

Visual Basic (宣言)

Public Shared Function DateSerial
 ( _
    Year As Integer, _
    Month As Integer, _
    Day As Integer _
) As DateTime

Visual Basic (使用法)

Dim Year As Integer
Dim Month As Integer
Dim Day As Integer
Dim returnValue As DateTime

returnValue = DateAndTime.DateSerial(Year, Month, Day)

C#

public static DateTime DateSerial (
    int Year,
    int Month,
    int Day
)

C++

public:
static DateTime DateSerial (
    int Year, 
    int Month, 
    int Day
)

J#

public static DateTime DateSerial (
    int Year, 
    int Month, 
    int Day
)

JScript

public static function DateSerial
 (
    Year : int, 
    Month : int, 
    Day : int
) : DateTime

パラメータ

Year

必須。1 ～ 9999 の整数型 (Integer) の式。ただし、この範囲より低い値も受け入れられます。Year が 0 ～ 99 の場合、下の「解説」で説明しているように、1930 ～ 2029 年として解釈されます。Year が 1 未満の場合、現在の年からその値が減算されます。

Month

必須。1 ～ 12 の整数型 (Integer) の式。ただし、この範囲外の値も受け入れられます。Month の値は 1 だけオフセットされた後、計算対象の年の 1 月に加算されます。つまり、(Month - 1) が 1 月に加算されます。年は必要に応じて再計算されます。この処理による結果の例を次に示します。

• Month が 1 の場合、結果は計算対象の年の 1 月になります。

• Month が 0 の場合、結果は前年の 12 月になります。

• If Month が -1 の場合、結果は前年の 11 月になります。

• Month が 13 の場合、結果は翌年の 1 月になります。

Day

必須。1 ～ 31 の整数型 (Integer) の式。ただし、この範囲外の値も受け入れられます。Day の値は 1 だけオフセットされた後、計算対象の月の最初の日に加算されます。つまり、(Day - 1) がその月の最初の日に加算されます。必要に応じて月と年が再計算されます。この処理による結果の例を次に示します。

• Day が 1 の場合、結果は計算対象の月の最初の日になります。

• Day が 0 の場合、結果は前月の末日になります。

• Day が -1 の場合、結果は前月の末日の前日になります。

• Day が現在の月の末日を過ぎている場合、結果は翌月の適切な日になります。たとえば、Month が 4 で Day が 31 の場合、結果は 5 月 1 日になります。

戻り値
指定された年、月、日を表す Date 値を返します。時刻情報は午前 0 時 (00:00:00) に設定されます。

解説

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

Windows 98 または Windows 2000 の場合、Year 引数に 2 桁の年を指定すると、ユーザーが定義したコンピュータの設定に基づいて解釈されます。既定の設定では、0 ～ 29 の値は 2000 ～ 2029 年として解釈され、30 ～ 99 の値は 1930 ～ 1999 年として解釈されます。これ以外の年を Year 引数に指定する場合は、4 桁の年を使用してください。たとえば、1924 などと指定します。

これより前のバージョンの Windows では、前に解説した既定の動作に基づいて 2 桁の年を解釈します。確実に適切な値が返されるようにするには、Year に 4 桁の年を指定してください。

次の例では、引数に負の値、0、正の値を指定した場合の動作を示します。ここでは、DateSerial 関数は今年の 10 年前の年の 3 月 1 日の前日、つまり 10 年前の 2 月末日を表す Date 値を返します。

Dim EndFeb As Date = DateSerial(-10, 3, 0)

Month または Day が通常の値の範囲を超えていた場合、次に大きな単位が適切に適用されます。たとえば、32 日を指定した場合、Month の値に応じて 1 か月と 1 ～ 4 日として解釈されます。Year が 9999 を超えている場合、またはいずれかの引数が -2,147,483,648 ～ 2,147,483,647 の範囲外の場合、ArgumentException エラーが発生します。3 つの引数により指定される日付が 1 年 1 月 1 日 の 0:00:00 よりも前の場合、または 9999 年 12 月 31 日の 23:59:59 よりも後の場合、ArgumentOutOfRangeException エラーが発生します。

Date データ型には時刻の要素が含まれています。この要素は DateSerial によってすべて 0 に設定されるため、戻り値の時刻は計算された日の午前 0 時となります。

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)

使用例

次に、DateSerial 関数を使用して指定した年月日の日付を返す例を示します。

Visual Basic

Dim MyDate As Date
' MyDate contains the date for February 12, 1969.
MyDate = DateSerial(1969, 2, 12)   ' Return a date.

プラットフォーム

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 名前空間
System
その他の技術情報
DateSerial 関数 (Visual Basic)
DateValue 関数 (Visual Basic)
Day 関数 (Visual Basic)
Month 関数 (Visual Basic)
Now プロパティ
TimeSerial 関数 (Visual Basic)
TimeValue 関数 (Visual Basic)
Weekday 関数 (Visual Basic)
Year 関数 (Visual Basic)
日付型 (Date) (Visual Basic)