TimeZoneInfo.IsAmbiguousTime メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。

オーバーロード

IsAmbiguousTime(DateTime)	特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。
IsAmbiguousTime(DateTimeOffset)	特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。

IsAmbiguousTime(DateTime)

ソース:

TimeZoneInfo.cs

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。

public:
 bool IsAmbiguousTime(DateTime dateTime);

public bool IsAmbiguousTime (DateTime dateTime);

member this.IsAmbiguousTime : DateTime -> bool

Public Function IsAmbiguousTime (dateTime As DateTime) As Boolean

パラメーター

dateTime

DateTime

日付と時刻の値。

戻り値

Boolean

true パラメーターがあいまいな場合は dateTime。それ以外の場合は false。

例外

ArgumentException

dateTime 値の Kind プロパティは Local で、dateTime は無効な時刻です。

例

太平洋タイム ゾーンでは、夏時間は 2007 年 11 月 4 日の午前 2 時に終了します。 次の例では、2007 年 11 月 4 日の午前 12 時 59 分から 2007 年 11 月 4 日の午前 2 時 1 分までの時間を、太平洋タイム ゾーンを表すオブジェクトのTimeZoneInfoメソッドにIsAmbiguousTime(DateTime)渡します。 コンソール出力は、2007 年 11 月 4 日の午前 1 時から 2007 年 11 月 4 日の午前 1 時 59 分までのすべての時間があいまいであることを示しています。

   // 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
let baseTime = DateTime(2007, 11, 4, 0, 59, 00, DateTimeKind.Unspecified)

// Get Pacific Standard Time zone
let pstZone = TimeZoneInfo.FindSystemTimeZoneById "Pacific Standard Time"

// List possible ambiguous times for 63-minute interval, from 12:59 AM to 2:01 AM 
for i = 0 to 62 do
// Because of assignment, newTime.Kind is also DateTimeKind.Unspecified
    let newTime = baseTime.AddMinutes i   
    printfn $"{newTime} is ambiguous: {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

注釈

あいまいな時刻は、現在のタイム ゾーンの時間の範囲内に含まれます。 これは、調整ルールの適用によって生じる標準時間または時刻のいずれかであることを意味します。 通常、時刻が夏時間から標準時に戻すように設定されている場合、あいまいな時刻が発生します。 図については、「例」セクションを参照してください。

協定世界時 (UTC) にはあいまいな時刻はありません。夏時間をサポートしないタイム ゾーンも実行しません。 したがって、これらのタイム ゾーンには調整規則がなく、 メソッドの呼び出しでは常に が IsAmbiguousTime 返されます false。

夏時間を監視するタイム ゾーンの場合、このメソッドの正確な動作は、次の表に示すように、 プロパティと TimeZoneInfo オブジェクトの関係Kindによって異なります。

TimeZoneInfo オブジェクトの種類	Kind プロパティの値	動作
TimeZoneInfo.Local	DateTimeKind.Local または DateTimeKind.Unspecified	パラメーターがあいまいかどうかを dateTime 判断します。
TimeZoneInfo.Local	DateTimeKind.Utc	現地時刻に変換 dateTime し、その時刻があいまいかどうかを判断します。
TimeZoneInfo.Utc	DateTimeKind.Utc または DateTimeKind.Unspecified	false を返します。
TimeZoneInfo.Utc	DateTimeKind.Local	があいまいな場合 dateTime は、標準時であると想定し、UTC に変換して を返します false。
その他のタイム ゾーン。	DateTimeKind.Local または DateTimeKind.Utc	指定したタイム ゾーンの時刻に変換 dateTime し、その時刻があいまいかどうかを判断します。
その他のタイム ゾーン。	DateTimeKind.Unspecified	があいまいかどうかを dateTime 判断します。

こちらもご覧ください

• IsInvalidTime(DateTime)

IsAmbiguousTime(DateTimeOffset)

ソース:

TimeZoneInfo.cs

特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。

public:
 bool IsAmbiguousTime(DateTimeOffset dateTimeOffset);

public bool IsAmbiguousTime (DateTimeOffset dateTimeOffset);

member this.IsAmbiguousTime : DateTimeOffset -> bool

Public Function IsAmbiguousTime (dateTimeOffset As DateTimeOffset) As Boolean

パラメーター

dateTimeOffset

DateTimeOffset

日付と時刻。

戻り値

Boolean

dateTimeOffset パラメーターが現在のタイム ゾーンであいまいな場合は true。それ以外の場合は false。

注釈

あいまいな時刻は、現在のタイム ゾーンの時間の範囲内に含まれます。 つまり、調整ルールの適用によって生じる標準時間または時刻を指定できます。 通常、時刻が夏時間から標準時に戻すように設定されている場合、あいまいな時刻が発生します。 協定世界時 (UTC) にはあいまいな時刻はありません。夏時間をサポートしないタイム ゾーンも実行しません。

メソッドの正確な動作は、 パラメーターの プロパティと現在のタイム ゾーンのdateTimeOffset関係Offsetによって異なります。 プロパティの値が現在の Offset タイム ゾーンの UTC から可能なオフセットである場合、メソッドはその日付と時刻があいまいかどうかを判断します。 それ以外の場合は、現在のタイム ゾーンの時刻に変換 dateTimeOffset し、その日付と時刻があいまいかどうかを判断します。