ctime_s
、、_ctime32_s
_ctime64_s
、_wctime_s
、、_wctime32_s
、_wctime64_s
將時間值轉換為字串並針對當地時區設定調整。 這些函式是 、 _wctime
_ctime64
、 的版本ctime
,_wctime64
具有 CRT 中安全性功能中所述的安全性增強功能。
語法
errno_t ctime_s(
char* buffer,
size_t numberOfElements,
const time_t *sourceTime
);
errno_t _ctime32_s(
char* buffer,
size_t numberOfElements,
const __time32_t *sourceTime
);
errno_t _ctime64_s(
char* buffer,
size_t numberOfElements,
const __time64_t *sourceTime )
;
errno_t _wctime_s(
wchar_t* buffer,
size_t numberOfElements,
const time_t *sourceTime
);
errno_t _wctime32_s(
wchar_t* buffer,
size_t numberOfElements,
const __time32_t *sourceTime
);
errno_t _wctime64_s(
wchar_t* buffer,
size_t numberOfElements,
const __time64_t *sourceTime
);
template <size_t size>
errno_t _ctime32_s(
char (&buffer)[size],
const __time32_t *sourceTime
); // C++ only
template <size_t size>
errno_t _ctime64_s(
char (&buffer)[size],
const __time64_t *sourceTime
); // C++ only
template <size_t size>
errno_t _wctime32_s(
wchar_t (&buffer)[size],
const __time32_t *sourceTime
); // C++ only
template <size_t size>
errno_t _wctime64_s(
wchar_t (&buffer)[size],
const __time64_t *sourceTime
); // C++ only
參數
buffer
必須足以容納 26 個字元。 字元字串結果的指標,如果 NULL
:
sourceTime
代表 1970 年 1 月 1 日午夜 (UTC) 以前的日期。如果您使用
_ctime32_s
或_wctime32_s
,sourceTime
代表 2038 年 1 月 18 日 23:59:59 (UTC) 以後的日期。如果您使用
_ctime64_s
或_wctime64_s
,sourceTime
代表 3000 年 12 月 31 日 23:59:59 (UTC) 以後的日期。如果您使用
_ctime_s
或_wctime_s
,這些函式是先前函式的包裝函式。 請參閱<備註>一節。
numberOfElements
緩衝區的大小。
sourceTime
預存時間的指標。
傳回值
如果成功,則為零。 如果因為參數無效而失敗,則會叫用無效的參數處理程式,如參數驗證中所述。 如果允許繼續執行,則會傳回錯誤碼。 錯誤碼定義於 ERRNO 中。H;如需這些錯誤的清單,請參閱 errno
。 下表顯示每個錯誤條件所擲回的實際錯誤碼。
錯誤條件
buffer |
numberOfElements |
sourceTime |
傳回 | buffer 中的值 |
---|---|---|---|---|
NULL |
任意 | 任意 | EINVAL |
未修改 |
非 NULL (指向有效的記憶體) |
0 | 任意 | EINVAL |
未修改 |
不是 NULL |
0< 大小 < 26 | 任意 | EINVAL |
空字串 |
不是 NULL |
>= 26 | NULL | EINVAL |
空字串 |
不是 NULL |
>= 26 | < 0 | EINVAL |
空字串 |
備註
函 ctime_s
式會將儲存為 time_t
結構的時間值轉換成字元字串。 值 sourceTime
通常是從呼叫 time
取得,其會傳回自午夜 (00:00:00)之後經過的秒數,1970 年 1 月 1 日,國際標準時間 (UTC)。 傳回值字串剛好包含 26 個字元,且具有以下格式:
Wed Jan 2 02:03:55 1980\n\0
使用 24 小時制。 所有欄位都具有固定寬度。 新行字元 ('\n') 和 null 字元 ('\0') 佔用字串的最後兩個位置。
已轉換的字元字串也會根據當地時區設定調整。 如需設定當地時間的資訊,請參閱 time
、 _ftime
和 localtime
函式。 如需定義時區環境和全域變數的詳細資訊,請參閱 函式 _tzset
。
_wctime32_s
和 _wctime64_s
是寬字元版本的 _ctime32_s
和 _ctime64_s
,並會傳回寬字元字串的指標。 否則,_ctime64_s
、_wctime32_s
和 _wctime64_s
的行為與 _ctime32_s
相同。
ctime_s
是評估為 _ctime64_s
的內嵌函式,而 time_t
相當於 __time64_t
。 如果您要強制編譯器將 time_t
解譯為舊的 32 位元 time_t
,您可以定義 _USE_32BIT_TIME_T
。 此巨集會導致 ctime_s
評估為 _ctime32_s
。 不建議這麼做,因為您的應用程式可能會在 2038 年 1 月 18 日之後失敗,而且 64 位平臺上不允許它。
在 C++ 中,使用這些函式已透過範本多載簡化;多載可自動推斷緩衝區長度,因而不需要指定大小引數。 如需詳細資訊,請參閱安全範本多載。
這些函式的偵錯連結庫版本會先將緩衝區填入0xFE。 若要停用此行為,請使用 _CrtSetDebugFillThreshold
。
根據預設,此函式的全域狀態會限定於應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
一般文字常式對應
TCHAR.H 常式 | _UNICODE 和 _MBCS 未定義 |
_MBCS 已定義 |
_UNICODE 已定義 |
---|---|---|---|
_tctime_s |
ctime_s |
ctime_s |
_wctime_s |
_tctime32_s |
_ctime32_s |
_ctime32_s |
_wctime32_s |
_tctime64_s |
_ctime64_s |
_ctime64_s |
_wctime64_s |
需求
常式 | 必要的標頭 |
---|---|
ctime_s 、 、 _ctime32_s _ctime64_s |
<time.h> |
_wctime_s 、 、 _wctime32_s _wctime64_s |
<time.h> 或 <wchar.h> |
如需相容性詳細資訊,請參閱相容性。
程式庫
所有版本的 C 執行階段程式庫。
範例
// crt_wctime_s.c
// This program gets the current
// time in time_t form and then uses _wctime_s to
// display the time in string form.
#include <time.h>
#include <stdio.h>
#define SIZE 26
int main( void )
{
time_t ltime;
wchar_t buf[SIZE];
errno_t err;
time( <ime );
err = _wctime_s( buf, SIZE, <ime );
if (err != 0)
{
printf("Invalid Arguments for _wctime_s. Error Code: %d\n", err);
}
wprintf_s( L"The time is %s\n", buf );
}
The time is Fri Apr 25 13:03:39 2003
另請參閱
時間管理
asctime_s
, _wasctime_s
ctime
、、_ctime32
_ctime64
、_wctime
、、_wctime32
、_wctime64
_ftime
、 、 _ftime32
_ftime64
gmtime_s
、 、 _gmtime32_s
_gmtime64_s
localtime_s
、 、 _localtime32_s
_localtime64_s
time
、 、 _time32
_time64
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應