TimeZoneInfo.IsAmbiguousTime メソッド

定義

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

オーバーロード

IsAmbiguousTime(DateTime)

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTimeOffset)

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

IsAmbiguousTime(DateTime)

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

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

パラメーター

dateTime
DateTime

日時の値。A date and time value.

戻り値

true パラメーターがあいまいな場合は dateTime。それ以外の場合は falsetrue if the dateTime parameter is ambiguous; otherwise, false.

例外

Kind 値の dateTime プロパティは Local で、dateTime は無効な時刻です。The Kind property of the dateTime value is Local and dateTime is an invalid time.

太平洋標準時ゾーンでは、夏時間は午前2:00 に終了します。In the Pacific Time zone, daylight saving time ends at 2:00 A.M. 2007年11月4日。on November 4, 2007. 次の例では、時刻を1分間隔で 12:59 A.M. から渡します。The following example passes the time at one-minute intervals from 12:59 A.M. 2007年11月4日から 2:01 A.M. までon November 4, 2007, to 2:01 A.M. 2007年11月4日に、太平洋標準時のタイムゾーンを表す TimeZoneInfo オブジェクトの IsAmbiguousTime(DateTime) メソッドにします。on November 4, 2007, to the IsAmbiguousTime(DateTime) method of a TimeZoneInfo object that represents the Pacific Time zone. コンソール出力は、すべての時刻が午前1:00 から始まることを示します。The console output indicates that all times from 1:00 A.M. 2007年11月4日から 1:59 A.M. までon November 4, 2007, to 1:59 A.M. 2007年11月4日にはあいまいです。on November 4, 2007, are ambiguous.

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

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

   // List possible ambiguous times for 63-minute interval, from 12:59 AM to 2: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 ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime));
   }
' Specify DateTimeKind in Date constructor
Dim baseTime As New Date(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)
Dim newTime As Date

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

' List possible ambiguous times for 63-minute interval, from 12:59 AM to 2: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 ambiguous: {1}", newTime, pstZone.IsAmbiguousTime(newTime))
Next

注釈

あいまいな時刻は、現在のタイムゾーンの時間範囲内にあります。An ambiguous time falls within a range of times for the current time zone. これは、調整規則の適用によって生成される標準時間または時刻のいずれかになります。This means it can be either a standard time or a time that results from the application of an adjustment rule. 通常、時刻が夏時間から標準時間に戻るように設定されている場合は、あいまいな時刻が返されます。Typically, ambiguous times result when the clock is set to return to standard time from daylight saving time. 図については、「例」を参照してください。See the Example section for an illustration.

協定世界時 (UTC) にはあいまいな時刻がありません。夏時間をサポートしていないタイムゾーンはありません。Coordinated Universal Time (UTC) has no ambiguous times; neither do time zones that do not support daylight saving time. したがって、これらのタイムゾーンには調整規則がなく、IsAmbiguousTime メソッドの呼び出しは常に falseを返します。Therefore, these time zones have no adjustment rules and calls to the IsAmbiguousTime method always return false.

夏時間を観察するタイムゾーンの場合、このメソッドの正確な動作は、次の表に示すように、Kind プロパティと TimeZoneInfo オブジェクトの関係によって異なります。For time zones that do observe daylight saving time, the precise behavior of this method depends on the relationship between the Kind property and the TimeZoneInfo object, as the following table shows.

TimeZoneInfo オブジェクトの種類TimeZoneInfo object type Kind プロパティ値Kind property value 動作Behavior
TimeZoneInfo.Local DateTimeKind.Local または DateTimeKind.UnspecifiedDateTimeKind.Local or DateTimeKind.Unspecified dateTime パラメーターがあいまいであるかどうかを判断します。Determines whether the dateTime parameter is ambiguous.
TimeZoneInfo.Local DateTimeKind.Utc dateTime を現地時刻に変換し、その時刻があいまいであるかどうかを判断します。Converts dateTime to the local time and then determines whether that time is ambiguous.
TimeZoneInfo.Utc DateTimeKind.Utc または DateTimeKind.UnspecifiedDateTimeKind.Utc or DateTimeKind.Unspecified false を返します。Returns false.
TimeZoneInfo.Utc DateTimeKind.Local dateTime があいまいな場合、は標準時であると見なし、UTC に変換して falseを返します。If dateTime is ambiguous, assumes it is a standard time, converts it to UTC, and returns false.
その他のタイムゾーン。Any other time zone. DateTimeKind.Local または DateTimeKind.UtcDateTimeKind.Local or DateTimeKind.Utc dateTime を指定したタイムゾーンの時刻に変換し、その時刻があいまいであるかどうかを判断します。Converts dateTime to the time in the specified time zone and then determines whether that time is ambiguous.
その他のタイムゾーン。Any other time zone. DateTimeKind.Unspecified dateTime があいまいであるかどうかを判断します。Determines whether dateTime is ambiguous.

こちらもご覧ください

IsAmbiguousTime(DateTimeOffset)

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。Determines whether a particular date and time in a particular time zone is ambiguous and can be mapped to two or more Coordinated Universal Time (UTC) times.

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);
public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);
member this.IsAmbiguousTime : DateTimeOffset -> bool

パラメーター

dateTimeOffset
DateTimeOffset

日付と時刻。A date and time.

戻り値

true パラメーターが現在のタイム ゾーンであいまいな場合は dateTimeOffset。それ以外の場合は falsetrue if the dateTimeOffset parameter is ambiguous in the current time zone; otherwise, false.

注釈

あいまいな時刻は、現在のタイムゾーンの時間範囲内にあります。An ambiguous time falls within a range of times for the current time zone. これは、調整規則の適用によって生成される標準時間または時刻のいずれかになります。This means that it can be either a standard time or a time that results from the application of an adjustment rule. 通常、時刻が夏時間から標準時間に戻るように設定されている場合は、あいまいな時刻が返されます。Typically, ambiguous times result when the clock is set to return to standard time from daylight saving time. 協定世界時 (UTC) にはあいまいな時刻がありません。夏時間をサポートしていないタイムゾーンはありません。Coordinated Universal Time (UTC) has no ambiguous times; neither do time zones that do not support daylight saving time.

メソッドの正確な動作は、dateTimeOffset パラメーターの Offset プロパティと現在のタイムゾーンとの関係によって異なります。The precise behavior of the method depends on the relationship between the Offset property of the dateTimeOffset parameter and the current time zone. Offset プロパティの値が、現在のタイムゾーンの UTC からのオフセットとして使用できる場合、メソッドは、その日付と時刻があいまいであるかどうかを判断します。If the value of the Offset property is a possible offset from the UTC of the current time zone, the method determines whether that date and time is ambiguous. それ以外の場合は、dateTimeOffset を現在のタイムゾーンの時刻に変換し、その日付と時刻があいまいであるかどうかを判断します。Otherwise, it converts dateTimeOffset to the time in the current time zone, and then determines whether that date and time is ambiguous.

適用対象