時間管理
時間管理関数は、現在時刻の取得、また必要に応じて時間の変換、調整、および格納に使用します。 現在の時刻はシステム時刻です。
_ftime ルーチンおよび localtime ルーチンでは、TZ 環境変数を使用します。 TZ が設定されていない場合、ランタイム ライブラリは、オペレーティング システムで指定されるタイム ゾーン情報を使用します。 この情報が使用できない場合は、既定値の PST8PDT を使用します。 TZ の詳細については、「_tzset」および「_daylight、_timezone、および _tzname」を参照してください。
時間ルーチン
関数 |
使用方法 |
同等の .NET Framework 関数 |
|---|---|---|
struct tm 型の時間を文字列に変換します。 _s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
System::DateTime::ToLongDateString、System::DateTime::ToLongTimeString、System::DateTime::ToShortDateString、System::DateTime::ToShortTimeString、System::DateTime::ToString |
|
処理に要したウォール クロック時間を返します。 |
使用できません。 標準 C 関数を呼び出すには、PInvoke を使用します。 詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64、_ctime_s、_ctime32_s、_ctime64_s、_wctime_s、_wctime32_s、_wctime64_s |
time_t、__time32_t、または __time64_t のいずれかの型の時間を文字列に変換します。 _s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
System::DateTime::GetDateTimeFormats、System::DateTime::ToString、System::DateTime::ToLongTimeString、System::DateTime::ToShortTimeString |
2 つの時間の差を計算します。 |
||
struct _timeb 型または struct __timeb64 型の変数に現在のシステム時刻を格納します。_s サフィックスが付いたこれらの関数のバージョンはセキュリティが強化されています。 |
||
開いているファイルの変更時刻を設定します。 |
System::IO::File::SetLastAccessTime、System::IO::File::SetLastWriteTime、System::IO::File::SetCreationTime |
|
gmtime、_gmtime32、_gmtime64, gmtime_s、_gmtime32_s、_gmtime64_s |
時刻を time_t 型から struct tm 型へ、または __time64_t 型から struct tm 型へ変換します。_s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
|
localtime、_localtime32、_localtime64, localtime_s、_localtime32_s、_localtime64_s |
時刻を現地のタイム ゾーンに合わせて修正し、time_t 型から struct tm へ、または __time64_t 型から struct tm へ変換します。 _s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
|
時間をグリニッジ標準時のカレンダーの値に変換します。 |
||
時間をカレンダーの値に変換します。 |
||
現在のシステム日付を文字列として返します。 _s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
使用できません。 標準 C 関数を呼び出すには、PInvoke を使用します。 詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
日付と時間の文字列を国際対応の書式に設定します。 |
System::DateTime::ToLongDateString、System::DateTime::ToLongTimeString、System::DateTime::ToShortDateString、System::DateTime::ToShortTimeString、System::DateTime::ToString |
|
現在のシステム時刻を文字列として返します。 _s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
System::DateTime::ToLongDateString、System::DateTime::ToLongTimeString、System::DateTime::ToShortDateString、System::DateTime::ToShortTimeString、System::DateTime::ToString |
|
現在のシステム時刻を time_t、 __time32_t、または __time64_t のいずれかの型として取得します。 |
使用できません。 標準 C 関数を呼び出すには、PInvoke を使用します。 詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
時間の外部変数を TZ 環境変数の値に設定します。 |
使用できません。 標準 C 関数を呼び出すには、PInvoke を使用します。 詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
|
指定されたファイルの変更時刻を、現在時刻または構造体に格納された時間値で設定します。 |
使用できません。 標準 C 関数を呼び出すには、PInvoke を使用します。 詳細については、「プラットフォーム呼び出しの例」を参照してください。 |
注意
の Microsoft C/C++ Version 7.0 を除く Microsoft C/C++ のすべてのバージョン、および Visual C++ のすべてのバージョンでは、time 関数が返す秒数が 1970 年 3 月 1 日午前 1 時からの経過したように現在の時刻を返します。Microsoft C/C++ Version 7.0 では、time 関数が返す現在時刻は、1899 年 12 月 31 日の 00 時 00 分 00 秒から経過した秒数です。
注意
Visual C++ 2005 以前の Visual C++ と Microsoft C/C++ のバージョンでは、time_tは long int (32 ビット)、3:14 をだったために使用できませんでした: 1 年 1 月 07 日 19 時 2038、UTC。time_tは __time64_t とともに、同じですが、_USE_32BIT_TIME_Tを定義することは __time32_tに time_tを変更し、多くの時刻関数に 32 ビット time_tを取得するバージョンを呼び出す。詳細については、「基本データ型」、および各時刻関数に関するドキュメント内のコメントを参照してください。