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:00 に開始されます。In the Pacific Time zone, daylight saving time begins at 2:00 A.M. 2006年4月2日。on April 2, 2006. 次のコードは、時刻を1分間隔で1:59 の午前から渡します。The following code passes the time at one-minute intervals from 1:59 A.M. 2006年4月2日、午前3:01 時にon 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:00 から始まることを示します。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に示すように、が無効な時刻を表しているかどうかに影響します。 dateTimeThe 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し、を返しfalseます。 TimeZoneInfoConverts 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.

適用対象

こちらもご覧ください