System::DateTime クラス

DateTime class

時間連続体上の特定の日付と時刻の値を表します。この型はスタック上に割り当て、値または参照で関数に渡すべきです。System::SmartPtr クラスを使用してこの型のオブジェクトを管理しないでください。

class DateTime

メソッド

メソッド説明
Add(TimeSpan) const現在のオブジェクトが表す日付と時刻に指定された時間間隔を加算した結果の日時を表す、DateTime クラスの新しいインスタンスを返します。
AddDays(double) const現在のオブジェクトが表す値と指定された日数の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddHours(double) const現在のオブジェクトが表す値と指定された時間数の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddMilliseconds(double) const現在のオブジェクトが表す値と指定されたミリ秒数の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddMinutes(double) const現在のオブジェクトが表す値と指定された分数の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddMonths(int) const現在のオブジェクトが表す値と指定された月数の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddSeconds(double) const現在のオブジェクトが表す値と指定された秒数の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddTicks(int64_t) const現在のオブジェクトが表す値と指定された 100 ナノ秒間隔の合計となる日時を表す、DateTime クラスの新しいインスタンスを返します。
AddYears(int) const現在のオブジェクトが表す日時の年コンポーネントを指定された数だけ増加させた日時を表す、DateTime クラスの新しいインスタンスを返します。
static Compare(DateTime, DateTime)指定された DateTime クラスのインスタンスが表す2つの値を比較し、時間軸上での相対的な位置を示す値を返します。
CompareTo(DateTime) const現在のオブジェクトと指定された DateTime クラスのインスタンスが表す2つの日付時刻値を比較し、時間軸上での相対的な位置を示す値を返します。
DateTime()最小可能な日時である MinValue と等しいインスタンスを構築します。
DateTime(int, int, int)特定の年、月、日で指定された日時を表すインスタンスを構築します。
DateTime(int, int, int, const SharedPtr<Globalization::Calendar>&)指定されたカレンダーで特定の年、月、日で指定された日時を表すインスタンスを構築します。
DateTime(int, int, int, int, int, int)特定の年、月、日、時、分、秒で指定された日時値を表すインスタンスを作成します。
DateTime(int, int, int, int, int, int, DateTimeKind)特定の年、月、日、時、分、秒で指定された日時値を表すインスタンスを作成します。
DateTime(int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&)指定されたカレンダーで、特定の年、月、日、時、分、秒で指定された日時値を表すインスタンスを作成します。
DateTime(int, int, int, int, int, int, int, DateTimeKind)特定の年、月、日、時、分、秒、ミリ秒で指定された日時値を表すインスタンスを作成します。
DateTime(int, int, int, int, int, int, int, const SharedPtr<Globalization::Calendar>&, DateTimeKind)指定されたカレンダーで、特定の年、月、日、時、分、秒、ミリ秒で指定された日時値を表すインスタンスを作成します。
DateTime(int64_t, DateTimeKind)ティック数で指定された日時値を表すインスタンスを作成します。
DateTime(int64_t, DateTimeKind, bool)ティック数で指定された日時値を表すインスタンスを作成します。内部使用専用。
DateTime(const DateTime&)インスタンスをコピー構築します。
static DaysInMonth(int, int)指定された年の指定された月の日数を返します。
static Equals(DateTime, DateTime)DateTime クラスの指定されたインスタンスが同じ日時値を表すかどうかを判断します。
Equals(DateTime) constDateTime クラスの指定されたインスタンスが現在のオブジェクトと同じ日時値を表すかどうかを判断します。
static FromBinary(int64_t)指定された符号なし 64 ビット整数から日時値をデシリアライズし、その値で新しい DateTime クラスのインスタンスを設定します。
static FromFileTime(int64_t)指定されたファイル時間を、ローカル時間と同じ日時値を表す DateTime クラスのインスタンスに変換します。
static FromFileTimeUtc(int64_t)指定されたファイル時間を、UTC 時間と同じ日時値を表す DateTime クラスのインスタンスに変換します。
static FromOADate(double)指定された OLE Automation Date と等価な日時値を表す DateTime クラスのインスタンスを返します。
static FromUnixTime(time_t)指定された Unix 時間値を DateTime クラスのインスタンスに変換します。内部使用専用。
get_Date() const現在のオブジェクトが表す日時のうち、時間部分の各コンポーネントを 0 に設定した日付部分だけを表す新しい DateTime クラスのインスタンスを返します。
get_Day() const現在のオブジェクトが表す月における日の序数を返します。
get_DayOfWeek() const現在のオブジェクトが表す曜日を表す値を返します。
get_DayOfYear() const現在のオブジェクトが表す年における日の序数を返します。
get_Hour() const現在のオブジェクトが表す日時値の時間コンポーネントを返します。
get_Kind() const現在のオブジェクトが表す日時がローカルか UTC か、あるいはどちらでもないかを表す値を返します。
get_Millisecond() const現在のオブジェクトが表す日時値のミリ秒コンポーネントを返します。
get_Minute() const現在のオブジェクトが表す日時値の分コンポーネントを返します。
get_Month() const現在のオブジェクトが表す年における月の序数を返します。
static get_Now()現在時刻をローカル時間として表す DateTime クラスのインスタンスを返します。
get_Second() const現在のオブジェクトが表す日時値の秒コンポーネントを返します。
get_Ticks() const現在のオブジェクトが表す日時まで、グレゴリオ暦の紀元元年1月1日 0:00:00 UTC から経過した 100 ナノ秒間隔の数を返します。
get_TimeOfDay() const現在のオブジェクトが表す日の開始時点から同オブジェクトが表す日時までの時間間隔を表す値を返します。
static get_Today()DateTime クラスのインスタンスを返します。このインスタンスは、オブジェクトが表す値の時間部分の各コンポーネントを 0 に設定した、現在の日付を表します。
static get_UtcNow()DateTime クラスのインスタンスを返します。このインスタンスは、現在の時刻を UTC として表します。
get_Year() const現在のオブジェクトが表す年を返します。
GetDateComponents(int&, int&, int&) const日付の部分を取得します。内部使用のみ。
GetDateTimeFormats() const標準の日付時刻書式指定子のいずれかでフォーマットされた、現在のオブジェクトの文字列表現を要素とする文字列配列を返します。
GetDateTimeFormats(char_t) const指定された標準の日付時刻書式指定子でフォーマットされた、現在のオブジェクトの文字列表現を要素とする文字列配列を返します。
GetDateTimeFormats(const SharedPtr<IFormatProvider>&) const標準の日付時刻書式指定子のいずれかと、指定された書式プロバイダーを使用してフォーマットされた、現在のオブジェクトの文字列表現を要素とする文字列配列を返します。
GetDateTimeFormats(char_t, const SharedPtr<IFormatProvider>&) const指定された標準の日付時刻書式指定子と書式プロバイダーでフォーマットされた、現在のオブジェクトの文字列表現を要素とする文字列配列を返します。
GetHashCode() const現在のオブジェクトのハッシュコードを返します。
IsDaylightSavingTime() const現在のオブジェクトが表す日時が、現在のタイムゾーンのサマータイム(夏時間)範囲に含まれるかどうかを判定します。
static IsLeapYear(int)指定された年がうるう年かどうかを判定します。
IsNull() const
operator!=(DateTime) const現在のオブジェクトと指定された DateTime オブジェクトが異なる日時値を表すかどうかを判定します。
operator!=(std::nullptr_t) const
operator+(TimeSpan) constDateTime クラスの新しいインスタンスを返します。このインスタンスは、現在のオブジェクトが表す値と指定された時間間隔の合計を表す日時値です。
operator+=(TimeSpan)現在のオブジェクトを、現在のオブジェクトが表す値と指定された時間間隔の合計である日時値に設定します。
operator-(TimeSpan) constDateTime クラスの新しいインスタンスを返します。このインスタンスは、現在のオブジェクトが表す値から指定された時間間隔を減算した結果の日時値を表します。
operator-(DateTime) const現在のオブジェクトと指定されたオブジェクトが表す日時値間の時間間隔を表す TimeSpan クラスのインスタンスを返します。
operator-=(TimeSpan)現在のオブジェクトを、現在のオブジェクトが表す日時値から指定された時間間隔を減算した結果の日時値に設定します。
operator<(DateTime) const現在のオブジェクトが、指定された DateTime オブジェクトが表す値よりも早い日時値を表すかどうかを判定します。
operator<(std::nullptr_t) const
operator<=(DateTime) const現在のオブジェクトが、指定された DateTime オブジェクトが表す値と同じかそれよりも早い日時値を表すかどうかを判定します。
operator<=(std::nullptr_t) const
operator=(const DateTime&)指定された DateTime インスタンスが表す値を現在のオブジェクトに代入します。
operator==(DateTime) const現在のオブジェクトと指定された DateTime オブジェクトが同じ日時値を表すかどうかを判定します。
operator==(std::nullptr_t) const
operator>(DateTime) const現在のオブジェクトが、指定された DateTime オブジェクトが表す値よりも後の日時値を表すかどうかを判定します。
operator>(std::nullptr_t) const
operator>=(DateTime) const現在のオブジェクトが、指定された DateTime オブジェクトが表す値と同じかそれよりも後の日時値を表すかどうかを判定します。
operator>=(std::nullptr_t) const
static Parse(const String&)指定された日時値の文字列表現を、同等の DateTime オブジェクトに変換します。
static Parse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)指定された日付と時刻値の文字列表現を、カルチャ固有の書式情報を使用して同等の DateTime オブジェクトに変換します。
static Parse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static Parse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static Parse(const String&, std::nullptr_t, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)指定された書式とカルチャ固有の書式情報を使用して、指定された日付と時刻値の文字列表現を同等の DateTime オブジェクトに変換します。文字列の書式は指定された書式と完全に一致している必要があります。変換に失敗した場合は例外をスローします。
static ParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles)指定された書式群、カルチャ固有の書式情報、およびスタイルを使用して、指定された日付と時刻値の文字列表現を同等の DateTime オブジェクトに変換します。文字列の書式は指定された書式のいずれかと完全に一致している必要があります。変換に失敗した場合は例外をスローします。
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles)
static ParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles)
static SpecifyKind(DateTime, DateTimeKind)指定された DateTime オブジェクトと同じティック数を表し、引数 kind で指定されたとおりにローカル時間、UTC 時間、またはどちらでもない時間を表す新しい DateTime オブジェクトを構築します。
Subtract(TimeSpan) constDateTime クラスの新しいインスタンスを返します。このインスタンスは、現在のオブジェクトが表す値から指定された時間間隔を減算した結果の日時値を表します。
Subtract(DateTime) const現在のオブジェクトと指定されたオブジェクトが表す日付と時刻の値の間の時間間隔を表す TimeSpan クラスのインスタンスを返します。
ToBinary() const現在のオブジェクトをシリアライズします。
ToFileTime() const現在のオブジェクトが表す日付と時刻の値をファイル時間として表す値を返します。
ToFileTimeUtc() const現在のオブジェクトが表す日付と時刻の値を UTC のファイル時間に変換します。
ToLocalTime() const現在のオブジェクトが表す日付と時刻の値をローカル時間として表す新しい DateTime クラスのインスタンスを返します。
ToLongDateString() const現在のオブジェクトの長い日付文字列表現を含む文字列を返します。
ToLongTimeString() const現在のオブジェクトの長い時刻文字列表現を含む文字列を返します。
ToOADate() const現在のオブジェクトが表す日付と時刻の値を OLE Automation Date として返します。
ToShortDateString() const現在のオブジェクトの短い日付文字列表現を含む文字列を返します。
ToShortTimeString() const現在のオブジェクトの短い時刻文字列表現を含む文字列を返します。
ToString() const現在のオブジェクトが表す日付と時刻の値を、現在のカルチャで定義された書式規則を使用して文字列として返します。
ToString(const String&) const現在のオブジェクトが表す日付と時刻の値を、指定された書式と現在のカルチャで定義された書式規則を使用して文字列として返します。
ToString(const SharedPtr<IFormatProvider>&) const現在のオブジェクトが表す日付と時刻の値を、指定された書式情報を使用して文字列として返します。
ToString(const SharedPtr<Globalization::CultureInfo>&) const
ToString(const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(std::nullptr_t) const
ToString(const String&, const SharedPtr<IFormatProvider>&) const現在のオブジェクトが表す日付と時刻の値を、指定された書式情報を使用して文字列として返します。
ToString(const String&, const SharedPtr<Globalization::CultureInfo>&) const
ToString(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&) const
ToString(const String&, std::nullptr_t) const
ToUniversalTime() const現在のオブジェクトが表す日付と時刻の値を UTC として表す新しい DateTime クラスのインスタンスを返します。
ToUnixTime() const現在のオブジェクトが表す日付と時刻の値を Unix 時間として表す値を返します。内部使用のみ。
static TryParse(const String&, DateTime&)指定された日時値の文字列表現を、同等の DateTime オブジェクトに変換します。
static TryParse(const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)指定されたカルチャ固有の書式情報とスタイルを使用して、指定された日付と時刻値の文字列表現を同等の DateTime オブジェクトに変換します。
static TryParse(const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParse(const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParse(const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)指定された書式、カルチャ固有の書式情報、およびスタイルを使用して、指定された日付と時刻値の文字列表現を同等の DateTime オブジェクトに変換します。文字列の書式は指定された書式と完全に一致している必要があります。
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const String&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<IFormatProvider>&, Globalization::DateTimeStyles, DateTime&)指定された書式群、カルチャ固有の書式情報、およびスタイルを使用して、指定された日付と時刻値の文字列表現を同等の DateTime オブジェクトに変換します。文字列の書式は指定された書式のいずれかと完全に一致している必要があります。
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::CultureInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, const SharedPtr<Globalization::DateTimeFormatInfo>&, Globalization::DateTimeStyles, DateTime&)
static TryParseExact(const String&, const ArrayPtr<String>&, std::nullptr_t, Globalization::DateTimeStyles, DateTime&)
static Type()このクラスに関する情報を含む TypeInfo オブジェクトを返します。

フィールド

フィールド説明
static constexpr MaxTicks最小可能な DateTime 値と最大可能な DateTime 値の間の時間間隔を表す 100 ナノ秒単位の数です。
static MaxValue最大可能な日付と時刻の値を表す DateTime クラスのインスタンスです。
static constexpr MinTicksDateTime クラスのインスタンスが表すことのできる最小のティック数です。
static MinValueDateTime クラスのインスタンスで、可能な最小の日付と時刻の値を表します。
static constexpr TicksPerDay1日あたりのティック数です。
static constexpr TicksPerHour1時間あたりのティック数です。
static constexpr TicksPerMicrosecond1マイクロ秒あたりのティック数です。
static constexpr TicksPerMillisecond1ミリ秒あたりのティック数です。
static constexpr TicksPerMinute1分あたりのティック数です。
static constexpr TicksPerSecond1秒あたりのティック数です。
static UnixEpochDateTime クラスのインスタンスで、Unix エポック開始 (1970.01.01 00:00:00) を表します。

備考

#include "system/console.h"
#include "system/date_time.h"

int main()
{
  using namespace System;

  // 'DateTime' クラスのインスタンスを作成します。
  DateTime dateTime{1990, 10, 30};

  // インスタンスを複数の形式で出力します。
  Console::WriteLine(dateTime.ToShortDateString());
  Console::WriteLine(dateTime.ToShortTimeString());
  Console::WriteLine(dateTime.ToString());

  return 0;
}
/*
This code example produces the following output:
30.10.1990
0:00
30.10.1990 0:00:00
*/

参照