std::ctime

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

日期和時間庫

時間點 time_point (C++11) clock_time_conversion (C++20)   clock_cast (C++20) 時長 duration (C++11) 時鐘 system_clock (C++11) steady_clock (C++11) is_clock (C++20) utc_clock (C++20) tai_clock (C++20) high_resolution_clock (C++11) gps_clock (C++20) file_clock (C++20) local_t (C++20) 日間時間 is_amis_pm (C++20)(C++20) make12make24 (C++20)(C++20) hh_mm_ss (C++20)

日曆 day (C++20) month (C++20) year (C++20) weekday (C++20) operator/ (C++20) year_month_day (C++20) year_month_day_last (C++20) year_month_weekday (C++20) year_month_weekday_last (C++20)   weekday_indexed (C++20) weekday_last (C++20) month_day (C++20) month_day_last (C++20) month_weekday (C++20) month_weekday_last (C++20) year_month (C++20) last_speclast (C++20)(C++20) chrono I/O parse (C++20)

時區 tzdb (C++20) tzdb_list (C++20) get_tzdbget_tzdb_listreload_tzdbremote_version (C++20)(C++20)(C++20)(C++20) sys_info (C++20) local_info (C++20) nonexistent_local_time (C++20) ambiguous_local_time (C++20) locate_zone (C++20) current_zone (C++20) time_zone (C++20) choose (C++20) zoned_traits (C++20) zoned_time (C++20) time_zone_link (C++20) leap_second (C++20) leap_second_info (C++20) get_leap_second_info (C++20) C風格日期和時間

 

C 風格日期和時間工具

函式

時間操作

difftime

time

clock

timespec_get (C++17)

格式轉換

asctime

ctime

strftime

wcsftime

gmtime

localtime

mktime

常量

CLOCKS_PER_SEC

型別

tm

time_t

clock_t

timespec (C++17)

 

定義於標頭檔案 <ctime>
char* ctime( const std::time_t* time );

將給定自紀元以來的時間轉換為日曆本地時間，然後轉換為文字表示，如同透過呼叫 std::asctime(std::localtime(time))。結果字串具有以下格式：

Www Mmm dd hh:mm:ss yyyy\n

• Www - 星期幾（Mon, Tue, Wed, Thu, Fri, Sat, Sun 之一）。
• Mmm - 月份（Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec 之一）。
• dd - 月份中的日期。
• hh - 小時。
• mm - 分鐘。
• ss - 秒。
• yyyy - 年份。

該函式不支援本地化。

引數

time

-

指向 std::time_t 物件的指標，指定要列印的時間

返回值

指向一個靜態的以 null 結尾的字元字串的指標，該字串包含日期和時間的文字表示。該字串可能在 std::asctime 和 std::ctime 之間共享，並且可能在這些函式每次呼叫時被覆蓋。

注意

此函式返回指向靜態資料的指標，並且不是執行緒安全的。此外，它會修改靜態的 std::tm 物件，該物件可能與 std::gmtime 和 std::localtime 共享。POSIX 將此函式標記為已過時，並推薦使用 std::strftime。

對於導致字串長度超過 25 個字元的 std::time_t 值（例如，年份 10000），行為可能是未定義的。

示例

執行此程式碼

#include <cassert>
#include <cstring>
#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(nullptr);
    std::cout << std::ctime(&result);
 
    char buffer[32];
    std::strncpy(buffer, std::ctime(&result), 26);
    assert('\n' == buffer[std::strlen(buffer) - 1]);
    std::cout << buffer;
}

可能的輸出

Mon Oct 11 17:10:55 2021
Mon Oct 11 17:10:55 2021

參閱

asctime	將 std::tm 物件轉換為文字表示 (函式)
strftime	將 std::tm 物件轉換為自定義文字表示 (函式)
put_time (C++11)	根據指定格式格式化並輸出日期/時間值 (函式模板)
C 文件 關於 ctime