asctime、_wasctime
文字列に tm 時刻の構造体に変換します。これらの関数のセキュリティを強化したバージョンについては、「asctime_s、_wasctime_s」を参照してください。
char *asctime(
const struct tm *timeptr
);
wchar_t *_wasctime(
const struct tm *timeptr
);
パラメーター
- timeptr
時間と日付の構造体。
戻り値
asctime は結果の文字列へのポインターを返します。; _wasctime はワイド文字列の結果へのポインターを返します。エラーの戻り値はありません。
解説
これらの関数のセキュリティを強化したバージョンがあります。; asctime_s_wasctime_s を参照してください。
asctime の関数は文字列を構造体として格納されている時刻を変換します。timeptr の値は通常呼び出しからの両方 tm の構造体へのポインターを返す localtime または TIME.H. で定義されている gmtime 派生します。
timeptr のメンバー |
値 |
|---|---|
tm_hour |
0-23 深夜) からの時間 |
tm_isdst |
夏時間が有効な場合は正 ; 夏時間が無効な場合は 0; 夏時間かどうかが不明な場合は負。C ランタイム ライブラリで夏時間の計算を実行するための米国の規則を (DST) 前提としています。 |
tm_mday |
月 (1-3) の日 |
tm_min |
時間 (分) の後 0-59 |
tm_mon |
月 (; 0-11 1 年 1 月 = 0) |
tm_sec |
分 (0-59 後の秒) |
tm_wday |
曜日 (; 0-6 の日 日曜日 = 0) |
tm_yday |
年 (; 0-365 の日 1 年 1 月 1 日 = 0) |
tm_year |
年 (1900 を引いた数の年) |
変換された文字列は、現地のタイム ゾーンの設定に合わせて調整されます。現地時刻の設定についてはタイム ゾーンの環境変数とグローバル変数の定義については時間_ftime と localtime の関数と関数 _tzset の " " を参照してください。
asctime で生成される結果の文字列が 26 文字を一つ含むフォーム Wed Jan 02 02:03:55 1980\n\0 があります。時刻は 24 時間制です。すべてのフィールドは固定幅です。改行文字および null 文字は文字列の最後の 2 か所に格納されます。asctime は文字列を単一の静的に割り当てたバッファーを使用します。この関数への呼び出しは前の呼び出しの結果を破棄します。
_wasctimeasctime はのワイド文字バージョンです。それ以外では、_wasctime と asctime の動作は同じです。
これらの関数では、パラメーターの検証が行われます。timeptr が null ポインターの場合またはの範囲の値を含む場合無効なパラメーター ハンドラーが パラメーターの検証 に説明されているように開始されます。実行の継続が許可された場合、この関数は NULL を返し、errno を EINVAL に設定します。
汎用テキスト ルーチンのマップ
TCHAR.H のルーチン |
_UNICODE および _MBCS が未定義の場合 |
_MBCS が定義されている場合 |
_UNICODE が定義されている場合 |
|---|---|---|---|
_tasctime |
asctime |
asctime |
_wasctime |
必要条件
ルーチン |
必須ヘッダー |
|---|---|
asctime |
<time.h> |
_wasctime |
<time.h> または <wchar.h> |
使用例
次にこのプログラムは asctime の関数を使用して出力の構造に newtime 長整数 aclock移動および文字列への変換にはシステム時刻を格納します。
// crt_asctime.c
// compile with: /W3
#include <time.h>
#include <stdio.h>
int main( void )
{
struct tm *newTime;
time_t szClock;
// Get time in seconds
time( &szClock );
// Convert time to struct tm form
newTime = localtime( &szClock );
// Print local time as a string.
printf_s( "Current date and time: %s", asctime( newTime ) ); // C4996
// Note: asctime is deprecated; consider using asctime_s instead
}
同等の .NET Framework 関数
参照
関連項目
ctime、_ctime32、_ctime64、_wctime、_wctime32、_wctime64