日付、時刻、およびタイム ゾーンDates, times, and time zones

.NET は基本的な DateTime 構造体だけでなく、タイム ゾーンでの作業をサポートする次のクラスも提供しています。In addition to the basic DateTime structure, .NET provides the following classes that support working with time zones:

  • TimeZone

    システムのローカル タイム ゾーンおよび世界協定時刻 (UTC) ゾーンで作業を行うには、このクラスを使用します。TimeZone クラスの機能は、TimeZoneInfo クラスによって大幅に置き換えられます。Use this class to work with the system's local time zone and the Coordinated Universal Time (UTC) zone.The functionality of the TimeZone class is largely superseded by the TimeZoneInfo class.

  • TimeZoneInfo

    このクラスを使用すると、システムに事前に定義されている任意のタイム ゾーンを処理し、新しいタイム ゾーンを作成して、1 つのタイム ゾーンから別のタイム ゾーンに日付/時刻を簡単に変換できます。Use this class to work with any time zone that is predefined on a system, to create new time zones, and to easily convert dates and times from one time zone to another. 新規に開発を行う場合は、TimeZoneInfo クラスではなく、TimeZone クラスを使用する必要があります。For new development, use the TimeZoneInfo class instead of the TimeZone class.

  • DateTimeOffset

    UTC からのオフセット (つまり時差) がわかっている日付および時刻で作業を行う場合は、この構造体を使用します。Use this structure to work with dates and times whose offset (or difference) from UTC is known. DateTimeOffset 構造体は、日付および時刻の値と、その時刻の UTC からのオフセットを組み合わせたものです。The DateTimeOffset structure combines a date and time value with that time's offset from UTC. UTC との関係により、個々の日付と時刻の値によって具体的な日時が明確に特定されます。Because of its relationship to UTC, an individual date and time value unambiguously identifies a single point in time. これにより、DateTime の値よりも、DateTimeOffset の値の方がコンピューター間で移植しやすくなります。This makes a DateTimeOffset value more portable from one computer to another than a DateTime value.

ドキュメントのこのセクションでは、タイム ゾーンでの作業を行ったり、あるタイム ゾーンから別のタイム ゾーンに日付と時刻を変換できる、タイム ゾーンに対応したアプリケーションを作成するために必要な情報を提供します。This section of the documentation provides the information that you need to work with time zones and to create time zone-aware applications that can convert dates and times from one time zone to another.

このセクションの内容In this section

タイム ゾーンの概要 タイム ゾーンに対応したアプリケーションの作成に関連する用語、概念、問題について説明します。Time zone overview Discusses the terminology, concepts, and issues involved in creating time zone-aware applications.

DateTime、DateTimeOffset、TimeSpan、および TimeZoneInfo の使い分け 日付および時刻のデータでの作業を行う場合、どのようなときに DateTimeDateTimeOffsetTimeZoneInfo の型を使用するかについて説明します。Choosing between DateTime, DateTimeOffset, TimeSpan, and TimeZoneInfo Discusses when to use the DateTime, DateTimeOffset, and TimeZoneInfo types when working with date and time data.

ローカル システムで定義されているタイム ゾーンの検索 ローカル システムで検出されたタイム ゾーンを列挙する方法について説明します。Finding the time zones defined on a local system Describes how to enumerate the time zones found on a local system.

方法: コンピューター上に存在するタイム ゾーンを列挙する コンピューターのレジストリに定義されているタイム ゾーンを列挙して、ユーザーが一覧から事前定義のタイム ゾーンを選択できるようにするための例を提供します。How to: Enumerate time zones present on a computer Provides examples that enumerate the time zones defined in a computer's registry and that let users select a predefined time zone from a list.

方法: 定義済みの UTC オブジェクトおよびローカル タイム ゾーン オブジェクトにアクセスする 世界協定時刻とローカル タイム ゾーンにアクセスする方法について説明します。How to: Access the predefined UTC and local time zone objects Describes how to access Coordinated Universal Time and the local time zone.

方法: TimeZoneInfo オブジェクトをインスタンス化する ローカル システムのレジストリから TimeZoneInfo オブジェクトをインスタンス化する方法について説明します。How to: Instantiate a TimeZoneInfo object Describes how to instantiate a TimeZoneInfo object from the local system registry.

DateTimeOffset オブジェクトのインスタンス化 DateTimeOffset オブジェクトをインスタンス化する方法、および DateTime の値を DateTimeOffset の値に変換する方法について説明します。Instantiating a DateTimeOffset object Discusses the ways in which a DateTimeOffset object can be instantiated, and the ways in which a DateTime value can be converted to a DateTimeOffset value.

方法: 調整規則のないタイム ゾーンを作成する 夏時間の調整をサポートしないカスタム タイム ゾーンを作成する方法について説明します。How to: Create time zones without adjustment rules Describes how to create a custom time zone that does not support the transition to and from daylight saving time.

方法 : 調整規則のあるタイム ゾーンを作成する 1 つ以上の夏時間調整をサポートするカスタム タイム ゾーンを作成する方法について説明します。How to: Create time zones with adjustment rules Describes how to create a custom time zone that supports one or more transitions to and from daylight saving time.

タイム ゾーンの保存と復元 タイム ゾーン データのシリアル化と逆シリアル化が TimeZoneInfo でどのようにサポートされるかを説明し、これらの機能を使用できるいくつかのシナリオを示します。Saving and restoring time zones Describes TimeZoneInfo support for serialization and deserialization of time zone data and illustrates some of the scenarios in which these features can be used.

方法 : 埋め込みリソースにタイム ゾーンを保存する カスタム タイム ゾーンを作成し、その情報をリソース ファイルに保存する方法について説明します。How to: Save time zones to an embedded resource Describes how to create a custom time zone and save its information in a resource file.

方法: 埋め込みリソースからタイム ゾーンを復元する 埋め込みリソース ファイルに保存されているカスタム タイム ゾーンをインスタンス化する方法について説明します。How to: Restore time zones from an embedded resource Describes how to instantiate custom time zones that have been saved to an embedded resource file.

日付と時刻を使用した算術演算の実行 DateTime および DateTimeOffset の値の加算、減算、比較に関連する問題について説明します。Performing arithmetic operations with dates and times Discusses the issues involved in adding, subtracting, and comparing DateTime and DateTimeOffset values.

方法: 日付と時刻の演算でタイム ゾーンを使用する タイム ゾーンの調整規則を反映する日付と時刻の演算を実行する方法について説明します。How to: Use time zones in date and time arithmetic Discusses how to perform date and time arithmetic that reflects a time zone's adjustment rules.

DateTime と DateTimeOffset 間の変換 DateTime の値と DateTimeOffset の値の変換方法について説明します。Converting between DateTime and DateTimeOffset Describes how to convert between DateTime and DateTimeOffset values.

タイム ゾーン間での時刻の変換 タイム ゾーン間での時刻の変換方法について説明します。Converting times between time zones Describes how to convert times from one time zone to another.

方法: あいまいな時刻を解決する 時刻をタイム ゾーンの標準時刻に対応させることで、あいまいな時刻を解決する方法について説明します。How to: Resolve ambiguous times Describes how to resolve an ambiguous time by mapping it to the time zone's standard time.

方法: ユーザーがあいまいな時刻を解決できるようにする ユーザーがあいまいな現地時刻と世界協定時刻の対応を決定できるようにする方法について説明します。How to: Let users resolve ambiguous times Describes how to let a user determine the mapping between an ambiguous local time and Coordinated Universal Time.

参照Reference

System.TimeZoneInfo