時間管理

時間管理関数は、現在時刻の取得、また必要に応じて時間の変換、調整、および格納に使用します。現在の時刻はシステム時刻です。

_ftime ルーチンおよび localtime ルーチンでは、TZ 環境変数を使用します。TZ が設定されていない場合、ランタイム ライブラリは、オペレーティング システムで指定されるタイム ゾーン情報を使用します。この情報が使用できない場合は、既定値の PST8PDT を使用します。TZ の詳細については、「_tzset」および「_daylight、_timezone、および _tzname」を参照してください。

時間ルーチン

Function

[条件]

同等の .NET Framework 関数

asctime、_wasctime, asctime_s、_wasctime_s

struct tm 型の時間を文字列に変換します。_s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。

System::DateTime::ToLongDateStringSystem::DateTime::ToLongTimeStringSystem::DateTime::ToShortDateStringSystem::DateTime::ToShortTimeStringSystem::DateTime::ToString

clock

処理に要したウォール クロック時間を返します。

該当なし標準 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::GetDateTimeFormatsSystem::DateTime::ToStringSystem::DateTime::ToLongTimeStringSystem::DateTime::ToShortTimeString

difftime、_difftime32、_difftime64

2 つの時間の差を計算します。

System::DateTime::Subtract

_ftime、_ftime32、_ftime64,_ftime_s、_ftime32_s、_ftime64_s

struct _timeb 型または struct__timeb64 型の変数に現在のシステム時刻を格納します。_s サフィックスが付いたこれらの関数のバージョンはセキュリティが強化されています。

System::DateTime::Now

_futime、_futime32、_futime64

開いているファイルの変更時刻を設定します。

System::IO::File::SetLastAccessTimeSystem::IO::File::SetLastWriteTimeSystem::IO::File::SetCreationTime

gmtime、_gmtime32、_gmtime64, gmtime_s、_gmtime32_s、_gmtime64_s

時刻を time_t 型から struct tm 型へ、または __time64_t 型から struct tm 型へ変換します。_s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。

System::DateTime::UtcNowSystem::DateTime::ToUniversalTime

localtime、_localtime32、_localtime64, localtime_s、_localtime32_s、_localtime64_s

時刻を現地のタイム ゾーンに合わせて修正し、time_t 型から struct tm へ、または __time64_t 型から struct tm へ変換します。_s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。

System::DateTime::ToLocalTime

_mkgmtime、_mkgmtime32、_mkgmtime64

時間をグリニッジ標準時のカレンダーの値に変換します。

System::DateTime::ToUniversalTime

mktime、_mktime32、_mktime64

時間をカレンダーの値に変換します。

System::DateTime::DateTime

_strdate、_wstrdate, _strdate_s、_wstrdate_s

現在のシステム日付を文字列として返します。_s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

strftime、wcsftime、_strftime_l、_wcsftime_l

日付と時間の文字列を国際対応の書式に設定します。

System::DateTime::ToLongDateStringSystem::DateTime::ToLongTimeStringSystem::DateTime::ToShortDateStringSystem::DateTime::ToShortTimeStringSystem::DateTime::ToString

_strtime、_wstrtime_strtime_s、_wstrtime_s

現在のシステム時刻を文字列として返します。_s サフィックスが付いたこれらの関数の各バージョンはセキュリティが強化されています。

System::DateTime::ToLongDateStringSystem::DateTime::ToLongTimeStringSystem::DateTime::ToShortDateStringSystem::DateTime::ToShortTimeStringSystem::DateTime::ToString

time、_time32、_time64

現在のシステム時刻を time_t、 __time32_t、または __time64_t のいずれかの型として取得します。

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

_tzset

時間の外部変数を TZ 環境変数の値に設定します。

該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。

_utime、_utime32、_utime64、_wutime、_wutime32、_wutime64

指定されたファイルの変更時刻を、現在時刻または構造体に格納された時間値で設定します。

該当なし標準 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 を取得するバージョンを呼び出すします。詳細については、「基本データ型」、および各時刻関数に関するドキュメント内のコメントを参照してください。

参照

関連項目

カテゴリ別ランタイム ルーチン