TimeZoneInfo.IsAmbiguousTime メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。
オーバーロード
IsAmbiguousTime(DateTime) |
特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。 |
IsAmbiguousTime(DateTimeOffset) |
特定のタイム ゾーンの特定の日付と時刻があいまいかどうか、および複数の世界協定時刻 (UTC) に割り当て可能かどうかを判断します。 |
IsAmbiguousTime(DateTime)
- ソース:
- TimeZoneInfo.cs
- ソース:
- TimeZoneInfo.cs
- ソース:
- 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
日付と時刻の値。
戻り値
true
パラメーターがあいまいな場合は dateTime
。それ以外の場合は false
。
例外
例
太平洋タイム ゾーンでは、夏時間は 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 判断します。 |
こちらもご覧ください
適用対象
IsAmbiguousTime(DateTimeOffset)
- ソース:
- TimeZoneInfo.cs
- ソース:
- TimeZoneInfo.cs
- ソース:
- 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
日付と時刻。
戻り値
dateTimeOffset
パラメーターが現在のタイム ゾーンであいまいな場合は true
。それ以外の場合は false
。
注釈
あいまいな時刻は、現在のタイム ゾーンの時間の範囲内に含まれます。 つまり、調整ルールの適用によって生じる標準時間または時刻を指定できます。 通常、時刻が夏時間から標準時に戻すように設定されている場合、あいまいな時刻が発生します。 協定世界時 (UTC) にはあいまいな時刻はありません。夏時間をサポートしないタイム ゾーンも実行しません。
メソッドの正確な動作は、 パラメーターの プロパティと現在のタイム ゾーンのdateTimeOffset
関係Offsetによって異なります。 プロパティの値が現在の Offset タイム ゾーンの UTC から可能なオフセットである場合、メソッドはその日付と時刻があいまいかどうかを判断します。 それ以外の場合は、現在のタイム ゾーンの時刻に変換 dateTimeOffset
し、その日付と時刻があいまいかどうかを判断します。
適用対象
.NET