英語で読む

次の方法で共有


DateTime 構造体

定義

特定の時点を表します。通常、日時形式で表されます。

public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, ISpanFormattable, System.Runtime.Serialization.ISerializable
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, System.Runtime.Serialization.ISerializable
public readonly struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IParsable<DateTime>, ISpanFormattable, ISpanParsable<DateTime>, IUtf8SpanFormattable, System.Runtime.Serialization.ISerializable
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
[System.Serializable]
public struct DateTime : IComparable, IConvertible, IFormattable
[System.Serializable]
public struct DateTime : IComparable, IComparable<DateTime>, IConvertible, IEquatable<DateTime>, IFormattable, System.Runtime.Serialization.ISerializable
public struct DateTime : IComparable, IComparable<DateTime>, IEquatable<DateTime>, IFormattable
継承
DateTime
属性
実装

注釈

この API の詳細については、「 DateTime の補足 API 解説」を参照してください。

コンストラクター

DateTime(DateOnly, TimeOnly)

指定した DateOnly および TimeOnlyに構造体のDateTime新しいインスタンスを初期化します。 新しいインスタンスには、 の種類があります Unspecified

DateTime(DateOnly, TimeOnly, DateTimeKind)

指定した に構造体の新しいインスタンスをDateTime初期化し、TimeOnly指定した DateOnly を尊重しますDateTimeKind

DateTime(Int32, Int32, Int32)

DateTime 構造体の新しいインスタンスを、指定した年、月、日に初期化します。

DateTime(Int32, Int32, Int32, Calendar)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、および日に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32)

DateTime 構造体の新しいインスタンスを、指定した年、月、日、時、分、および秒に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、および秒に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)

DateTime 構造体の新しいインスタンスを、指定した年、月、日、時、分、秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32)

DateTime 構造体の新しいインスタンスを、指定した年、月、日、時、分、秒、およびミリ秒に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、秒、およびミリ秒に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、秒、ミリ秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)

DateTime 構造体の新しいインスタンスを、指定した年、月、日、時、分、秒、ミリ秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、秒、ミリ秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、秒、ミリ秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, Calendar, DateTimeKind)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、秒、ミリ秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int32, Int32, Int32, Int32, Int32, Int32, Int32, Int32, DateTimeKind)

DateTime 構造体の新しいインスタンスを、指定した暦の指定した年、月、日、時、分、秒、ミリ秒、および世界協定時刻 (UTC) または現地時刻に初期化します。

DateTime(Int64)

DateTime 構造体の新しいインスタンスを、指定したタイマー刻み数に初期化します。

DateTime(Int64, DateTimeKind)

DateTime 構造体の新しいインスタンスを、指定したタイマー刻み数と世界協定時刻 (UTC) または現地時刻に初期化します。

フィールド

MaxValue

DateTime の最大有効値を表します。 このフィールドは読み取り専用です。

MinValue

DateTime の最小有効値を表します。 このフィールドは読み取り専用です。

UnixEpoch

この定数の値は、グレゴリオ暦での 1970 年 1 月 1 日 00:00:00.0000000 UTC に相当します。 UnixEpoch によって、UNIX 時刻が 0 に等しい特定の時点が定義されます。

プロパティ

Date

このインスタンスの日付の部分を取得します。

Day

このインスタンスで表される月の日付を取得します。

DayOfWeek

このインスタンスで表される曜日を取得します。

DayOfYear

このインスタンスで表される年間積算日を取得します。

Hour

このインスタンスで表される日付の時間の部分を取得します。

Kind

このインスタンスが表す時刻の種類 (現地時刻、世界協定時刻 (UTC)、または、そのどちらでもない) を示す値を取得します。

Microsecond

マイクロ秒コンポーネント。0 ~ 999 の値として表されます。

Millisecond

このインスタンスで表される日付のミリ秒の部分を取得します。

Minute

このインスタンスで表される日付の分の部分を取得します。

Month

このインスタンスで表される日付の月の部分を取得します。

Nanosecond

nanoseconds コンポーネント。0 ~ 900 (100 ナノ秒単位) の値として表されます。

Now

コンピューター上の現在の日時を現地時刻で表した DateTime オブジェクトを取得します。

Second

このインスタンスで表される日付の秒の部分を取得します。

Ticks

このインスタンスの日付と時刻を表すタイマー刻み数を取得します。

TimeOfDay

このインスタンスの時刻を取得します。

Today

現在の日付を取得します。

UtcNow

コンピューター上の現在の日時を世界協定時刻 (UTC) で表した DateTime オブジェクトを取得します。

Year

このインスタンスで表される日付の年の部分を取得します。

メソッド

Add(TimeSpan)

このインスタンスの値に、指定された TimeSpan の値を加算した新しい DateTime を返します。

AddDays(Double)

このインスタンスの値に、指定された日数を加算した新しい DateTime を返します。

AddHours(Double)

このインスタンスの値に、指定された時間数を加算した新しい DateTime を返します。

AddMicroseconds(Double)

指定したマイクロ秒数をこのインスタンスの値に加算する新しい DateTime を返します。

AddMilliseconds(Double)

このインスタンスの値に、指定されたミリ秒数を加算した新しい DateTime を返します。

AddMinutes(Double)

このインスタンスの値に、指定された分数を加算した新しい DateTime を返します。

AddMonths(Int32)

このインスタンスの値に、指定された月数を加算した新しい DateTime を返します。

AddSeconds(Double)

このインスタンスの値に、指定された秒数を加算した新しい DateTime を返します。

AddTicks(Int64)

このインスタンスの値に、指定されたタイマー刻みの数を加算した新しい DateTime を返します。

AddYears(Int32)

このインスタンスの値に、指定された年数を加算した新しい DateTime を返します。

Compare(DateTime, DateTime)

DateTime の 2 つのインスタンスを比較し、第 1 のインスタンスが第 2 のインスタンスよりも前か、同じか、それとも後かを示す整数を返します。

CompareTo(DateTime)

このインスタンスの値と指定した DateTime の値を比較し、このインスタンスの値が指定した DateTime の値よりも前か、同じか、または後かを示す整数を返します。

CompareTo(Object)

このインスタンスの値と指定した DateTime の値を含む指定したオブジェクトを比較し、このインスタンスの値が指定した DateTime の値よりも前か、同じか、または後かを示す整数を返します。

DaysInMonth(Int32, Int32)

指定した月および年の日数を返します。

Deconstruct(DateOnly, TimeOnly)

と によってこのDateTimeインスタンスをDateOnlyTimeOnly分解します。

Deconstruct(Int32, Int32, Int32)

、、および によってこのDateOnlyインスタンスをYearMonth分解しますDay

Equals(DateTime)

このインスタンスの値が、指定した DateTime インスタンスの値と等しいかどうかを示す値を返します。

Equals(DateTime, DateTime)

2 つの DateTime インスタンスの日付と時刻の値が同じかどうかを示す値を返します。

Equals(Object)

このインスタンスが指定されたオブジェクトに等しいかどうかを示す値を返します。

FromBinary(Int64)

64 ビットのバイナリ値を逆シリアル化し、元のシリアル化 DateTime オブジェクトを再構築します。

FromFileTime(Int64)

指定された Windows ファイル時刻を同等の現地時刻に変換します。

FromFileTimeUtc(Int64)

指定された Windows ファイル時刻を同等の UTC 時刻に変換します。

FromOADate(Double)

指定した OLE オートメーション日付と等しい DateTime を返します。

GetDateTimeFormats()

このインスタンスの値を、標準の日時形式指定子によってサポートされるすべての文字列形式に変換します。

GetDateTimeFormats(Char)

このインスタンスの値を、指定した標準の日時形式指定子によってサポートされるすべての文字列表記に変換します。

GetDateTimeFormats(Char, IFormatProvider)

このインスタンスの値を、指定した標準日時形式指定子およびカルチャ固有の書式情報によってサポートされる、すべての文字列形式に変換します。

GetDateTimeFormats(IFormatProvider)

このインスタンスの値を、標準日時形式指定子および指定したカルチャ固有の書式情報によってサポートされる、すべての文字列形式に変換します。

GetHashCode()

このインスタンスのハッシュ コードを返します。

GetTypeCode()

DateTime 値型の TypeCode を返します。

IsDaylightSavingTime()

DateTime のインスタンスが、現在のタイム ゾーンの夏時間の期間内であるかどうかを示します。

IsLeapYear(Int32)

指定された年が閏年かどうかを示す値を返します。

Parse(ReadOnlySpan<Char>, IFormatProvider)

文字のスパンを値に解析します。

Parse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

カルチャ固有の書式情報と書式スタイルを使用して、日付と時刻の文字列形式を含むメモリ範囲を等価の DateTime に変換します。

Parse(String)

現在のカルチャの規則を使用して、日付と時刻 DateTime の文字列表現を同等の形式に変換します。

Parse(String, IFormatProvider)

カルチャ固有の書式情報を使用して、日付と時刻の文字列形式を等価の DateTime に変換します。

Parse(String, IFormatProvider, DateTimeStyles)

カルチャ固有の書式情報と書式スタイルを使用して、日付と時刻の文字列形式を等価の DateTime に変換します。

ParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles)

指定した書式、カルチャ固有の書式情報、スタイルを使用して、指定した日付と時刻のスパン表現を、それと等価な DateTime に変換します。 文字列形式の書式は、指定した書式と完全に一致する必要があります。それ以外の場合は、例外がスローされます。

ParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles)

指定した書式の配列、カルチャ固有の書式情報、スタイルを使用して、指定した日付と時刻のスパン表現を、それと等価な DateTime に変換します。 文字列形式の書式は、指定した書式の少なくとも 1 つと完全に一致する必要があります。それ以外の場合は、例外がスローされます。

ParseExact(String, String, IFormatProvider)

指定した書式とカルチャ固有の書式情報を使用して、指定した日付と時刻の文字列形式を等価の DateTime の値に変換します。 文字列形式の書式は、指定した書式と完全に一致する必要があります。

ParseExact(String, String, IFormatProvider, DateTimeStyles)

指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。 文字列形式の書式は、指定した書式と完全に一致する必要があります。それ以外の場合は、例外がスローされます。

ParseExact(String, String[], IFormatProvider, DateTimeStyles)

指定した書式の配列、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。 文字列形式の書式は、指定した書式の少なくとも 1 つと完全に一致する必要があります。それ以外の場合は、例外がスローされます。

SpecifyKind(DateTime, DateTimeKind)

指定された DateTime と同じタイマー刻みの数を持つ新しい DateTime オブジェクトを、指定された DateTimeKind 値 (現地時刻、世界協定時刻 (UTC)、または、そのいずれでもないことを示す) に基づいて作成します。

Subtract(DateTime)

このインスタンスの値から指定した日時を減算した、新しい TimeSpan を返します。

Subtract(TimeSpan)

このインスタンスの値から指定した期間を減算した、新しい DateTime を返します。

ToBinary()

現在の DateTime オブジェクトを 64 ビットのバイナリ値にシリアル化します。後で、この値を使って、DateTime オブジェクトを再構築できます。

ToFileTime()

現在の DateTime オブジェクトの値を Windows ファイル時刻に変換します。

ToFileTimeUtc()

現在の DateTime オブジェクトの値を Windows ファイル時刻に変換します。

ToLocalTime()

現在の DateTime オブジェクトの値を現地時刻に変換します。

ToLongDateString()

現在の DateTime オブジェクトの値を、それと等価な長い形式の日付の文字列形式に変換します。

ToLongTimeString()

現在の DateTime オブジェクトの値を、それと等価な長い形式の時刻の文字列形式に変換します。

ToOADate()

このインスタンスの値をそれと等価な OLE オートメーション日付に変換します。

ToShortDateString()

現在の DateTime オブジェクトの値を、それと等価な短い形式の日付の文字列形式に変換します。

ToShortTimeString()

現在の DateTime オブジェクトの値を、それと等価な短い形式の時刻の文字列形式に変換します。

ToString()

現在のカルチャの書式指定規則を使用して、現在の DateTime オブジェクトの値をそれと等価な文字列形式に変換します。

ToString(IFormatProvider)

指定したカルチャ固有の書式情報を使用して、現在の DateTime オブジェクトの値をそれと等価な文字列形式に変換します。

ToString(String)

指定した形式および現在のカルチャの書式指定規則を使用して、現在の DateTime オブジェクトの値をそれと等価な文字列形式に変換します。

ToString(String, IFormatProvider)

指定した書式およびカルチャ固有の書式情報を使用して、現在の DateTime オブジェクトの値をそれと等価の文字列形式に変換します。

ToUniversalTime()

現在の DateTime オブジェクトの値を世界協定時刻 (UTC) に変換します。

TryFormat(Span<Byte>, Int32, ReadOnlySpan<Char>, IFormatProvider)

現在のインスタンスの値を UTF-8 として指定されたバイトスパンに書式設定しようとします。

TryFormat(Span<Char>, Int32, ReadOnlySpan<Char>, IFormatProvider)

現在の DateTime 型のインスタンスの値を、指定した文字スパンに書式設定しようとします。

TryParse(ReadOnlySpan<Char>, DateTime)

指定した日付と時刻の文字スパンを、それと等価な DateTime に変換し、変換が成功したかどうかを示す値を返します。

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTime)

文字のスパンを値に解析しようとします。

TryParse(ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

指定したカルチャ固有の書式情報と書式スタイルを使用して、日付と時刻のスパン表現を、それと等価な DateTime に変換し、変換が成功したかどうかを示す値を返します。

TryParse(String, DateTime)

指定した文字列形式の日時を対応する DateTime 表現に変換し、変換に成功したかどうかを示す値を返します。

TryParse(String, IFormatProvider, DateTime)

文字列を値に解析しようとします。

TryParse(String, IFormatProvider, DateTimeStyles, DateTime)

指定したカルチャ固有の書式情報と書式スタイルを使用して、指定した文字列形式の日付と時刻をそれと等価の DateTime に変換し、変換に成功したかどうかを示す値を返します。

TryParseExact(ReadOnlySpan<Char>, ReadOnlySpan<Char>, IFormatProvider, DateTimeStyles, DateTime)

指定した書式、カルチャ固有の書式情報、スタイルを使用して、指定した日付と時刻のスパン表現を、それと等価な DateTime に変換します。 文字列形式の書式は、指定した書式と完全に一致する必要があります。 このメソッドは、変換に成功したかどうかを示す値を返します。

TryParseExact(ReadOnlySpan<Char>, String[], IFormatProvider, DateTimeStyles, DateTime)

指定した日付と時刻の文字スパンを、それと等価な DateTime に変換し、変換が成功したかどうかを示す値を返します。

TryParseExact(String, String, IFormatProvider, DateTimeStyles, DateTime)

指定した書式、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。 文字列形式の書式は、指定した書式と完全に一致する必要があります。 このメソッドは、変換に成功したかどうかを示す値を返します。

TryParseExact(String, String[], IFormatProvider, DateTimeStyles, DateTime)

指定した書式の配列、カルチャ固有の書式情報、およびスタイルを使用して、指定した日付と時刻の文字列形式を等価の DateTime に変換します。 文字列形式の書式は、指定した書式の少なくとも 1 つと完全に一致する必要があります。 このメソッドは、変換に成功したかどうかを示す値を返します。

演算子

Addition(DateTime, TimeSpan)

指定した日付と時刻に指定した時間間隔を加算して、新しい日付と時刻を作成します。

Equality(DateTime, DateTime)

DateTime の 2 つの指定したインスタンスが等しいかどうかを判断します。

GreaterThan(DateTime, DateTime)

指定した DateTime が、指定したもう 1 つの DateTime より後の時刻かどうかを判断します。

GreaterThanOrEqual(DateTime, DateTime)

指定した 1 つの DateTime が、指定した別の DateTime と同じ日時またはそれより後の日時を表しているかどうかを判断します。

Inequality(DateTime, DateTime)

DateTime の 2 つの指定したインスタンスが等しいかどうかを判断します。

LessThan(DateTime, DateTime)

指定した DateTime が、指定したもう 1 つの DateTime より前の時刻かどうかを判断します。

LessThanOrEqual(DateTime, DateTime)

指定した 1 つの DateTime が、指定した別の DateTime と同じ日時またはそれより前の日時を表しているかどうかを判断します。

Subtraction(DateTime, DateTime)

指定した日付と時刻から指定したもう 1 つの日付と時刻を減算して、時間間隔を返します。

Subtraction(DateTime, TimeSpan)

指定した日付と時刻から指定した時間間隔を減算して、新しい日付と時刻を返します。

明示的なインターフェイスの実装

IComparable.CompareTo(Object)

現在のインスタンスを同じ型の別のオブジェクトと比較し、現在のインスタンスの並べ替え順序での位置が、比較対象のオブジェクトと比べて前か、後か、または同じかを示す整数を返します。

IConvertible.GetTypeCode()

インスタンスの TypeCode を返します。

IConvertible.ToBoolean(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToByte(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToChar(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToDateTime(IFormatProvider)

現在の DateTime オブジェクトを返します。

IConvertible.ToDecimal(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToDouble(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToInt16(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToInt32(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToInt64(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToSByte(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToSingle(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToType(Type, IFormatProvider)

現在の DateTime オブジェクトを、指定された型のオブジェクトに変換します。

IConvertible.ToUInt16(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToUInt32(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

IConvertible.ToUInt64(IFormatProvider)

この変換はサポートされていません。 このメソッドを使用しようとすると、InvalidCastException がスローされます。

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

SerializationInfo オブジェクトに、現在の DateTime オブジェクトをシリアル化するために必要なすべてのデータを格納します。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

スレッド セーフ

この型のすべてのメンバーはスレッド セーフです。 インスタンスの状態を変更するように見えるメンバーは、実際には新しい値で初期化された新しいインスタンスを返します。 他の型と同様に、この型のインスタンスを含む共有変数の読み取りと書き込みは、スレッドセーフを保証するためにロックによって保護する必要があります。

こちらもご覧ください