時間管理
時間管理関数は、現在時刻の取得、また必要に応じて時間の変換、調整、および格納に使用します。現在の時刻はシステム時刻です。
_ftime ルーチンおよび localtime ルーチンでは、TZ 環境変数を使用します。TZ が設定されていない場合、ランタイム ライブラリは、オペレーティング システムで指定されるタイム ゾーン情報を使用します。この情報が使用できない場合は、既定値の PST8PDT を使用します。TZ の詳細については、「_tzset」および「_daylight、_timezone、および _tzname」を参照してください。
時間ルーチン
Function |
[条件] |
同等の .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 サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
|
時間をグリニッジ標準時のカレンダーの値に変換します。 |
||
時間をカレンダーの値に変換します。 |
System::DateTime::DateTime |
|
現在のシステム日付を文字列として返します。_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++ のすべてのバージョン時刻関数は秒数が 1970 年 1 月 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 を取得するバージョンを呼び出すします。詳細については、「基本データ型」、および各時刻関数に関するドキュメント内のコメントを参照してください。