TimeZoneInfo.IsInvalidTime(DateTime) TimeZoneInfo.IsInvalidTime(DateTime) TimeZoneInfo.IsInvalidTime(DateTime) Method

定義

指定された日付と時刻が無効かどうかを示します。Indicates whether a particular date and time is invalid.

public:
 bool IsInvalidTime(DateTime dateTime);
public bool IsInvalidTime (DateTime dateTime);
member this.IsInvalidTime : DateTime -> bool

パラメーター

dateTime
DateTime DateTime DateTime

日付と時刻の値。A date and time value.

戻り値

dateTime が無効の場合は true。それ以外の場合は falsetrue if dateTime is invalid; otherwise, false.

太平洋標準時ゾーンで夏時間が午前 2 時に開始します。In the Pacific Time zone, daylight saving time begins at 2:00 A.M. 2006 年年 4 月 2 日。on April 2, 2006. 次のコードは、午前 1 時 59 分: から 1 分間隔で、時間を渡しますThe following code passes the time at one-minute intervals from 1:59 A.M. で、2006 年 4 月 2日 3時 01分 amon April 2, 2006, to 3:01 A.M. 2006 年 4 月 2 日に、IsInvalidTimeのメソッド、TimeZoneInfo太平洋標準時タイム ゾーンを表すオブジェクト。on April 2, 2006, to the IsInvalidTime method of a TimeZoneInfo object that represents the Pacific Time zone. コンソール出力が午前 2 時からそのすべての回数を示しますThe console output indicates that all times from 2:00 A.M. 2006 年 4 月 2日午前 2時 59分までのon April 2, 2006, to 2:59 A.M. 2006 年 4 月 2 日は無効です。on April 2, 2006, are invalid.

// Specify DateTimeKind in Date constructor
DateTime baseTime = new DateTime(2007, 3, 11, 1, 59, 0, DateTimeKind.Unspecified);
DateTime newTime;

// Get Pacific Standard Time zone
TimeZoneInfo pstZone = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time");

// List possible invalid times for a 63-minute interval, from 1:59 AM to 3:01 AM
for (int ctr = 0; ctr < 63; ctr++)
{
   // Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr);
   Console.WriteLine("{0} is invalid: {1}", newTime, pstZone.IsInvalidTime(newTime));
}
' Specify DateTimeKind in Date constructor
Dim baseTime As New Date(2007, 3, 11, 1, 59, 0, DateTimeKind.Unspecified)
Dim newTime As Date

' Get Pacific Standard Time zone
Dim pstZone As TimeZoneInfo = TimeZoneInfo.FindSystemTimeZoneById("Pacific Standard Time")

' List possible invalid times for 63-minute interval, from 1:59 AM to 3:01 AM
For ctr As Integer = 0 To 62
   ' Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
   newTime = baseTime.AddMinutes(ctr)
   Console.WriteLine("{0} is invalid: {1}", newTime, pstZone.IsInvalidTime(newTime))
Next

注釈

無効な時刻は、現在のタイム ゾーン調整規則の適用により世界協定時刻 (UTC) をマップできない時間の範囲内にあります。An invalid time falls within a range of times for the current time zone that cannot be mapped to Coordinated Universal Time (UTC) due to the application of an adjustment rule. 通常、無効な時刻は、時刻は夏時間の前方に移動したときに発生します。Typically, invalid times occur when the time moves ahead for daylight saving time. 図の例のセクションを参照してください。See the Example section for an illustration.

値、Kindのプロパティ、dateTimeパラメーターに影響するかどうかdateTimeとして次の表は、無効な時刻を表します。The value of the Kind property of the dateTime parameter affects whether dateTime represents an invalid time, as the following table shows.

DateTime.Kind プロパティDateTime.Kind property TimeZoneInfo オブジェクト (該当する場合)TimeZoneInfo object (if applicable) 動作Behavior
DateTimeKind.Local TimeZoneInfo.Local 時間が有効かどうかを判断します。Determines whether the time is invalid.
DateTimeKind.Local TimeZoneInfo.Utc または、ローカル以外のタイム ゾーンを選択します。TimeZoneInfo.Utc or a non-local time zone. 変換dateTimeの時刻に、TimeZoneInfoオブジェクトを返しますfalseします。Converts dateTime to the time of the TimeZoneInfo object and returns false.
DateTimeKind.Unspecified 該当なし。Not applicable. 前提としていますdateTimeの時間、TimeZoneInfoオブジェクトし、が正しくないかどうかを決定します。Assumes dateTime is the time of the TimeZoneInfo object and determines whether it is invalid.
DateTimeKind.Utc 該当なし。Not applicable. false を返します。Returns false.

適用対象

こちらもご覧ください