時間管理
更新 : 2007 年 11 月
時間管理関数は、現在時刻の取得、また必要に応じて時間の変換、調整、および格納に使用します。現在の時刻はシステム時刻です。
_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 |
|
処理に要した経過 CPU 時間を返します。 |
適用できません。標準 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 サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。 |
||
日付と時間の文字列を国際対応の書式に設定します。 |
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++ のすべてのバージョン、および Microsoft Visual C++ 2005 のすべてのバージョンでは、time 関数が返す現在時刻は、1970 年 1 月 1 日の 00 時 00 分 00 秒から経過した秒数です。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 ビット) だったため、UTC の 2038 年 1 月 19 日 03 時 14 分 07 秒以降の日付には使用できませんでした。Visual C++ 2005 では、time_t は、既定で __time64_t に相当しますが、_USE_32BIT_TIME_T を定義すると、time_t が __time32_t に変更され、32 ビットの time_t を取得するバージョンを呼び出す多くの時刻関数が実行されます。詳細については、「基本データ型」、および各時刻関数に関するドキュメント内のコメントを参照してください。 |