C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- std::chrono::duration
- std::chrono::time_point
- C 日期和时间工具
- std::clock
- std::clock_t
- std::asctime
- std::timespec_get
- std::time
- std::localtime
- std::mktime
- std::wcsftime
- std::gmtime
- CLOCKS_PER_SEC
- std::time_t
- std::tm
- std::timespec
- std::difftime
- std::ctime
- std::strftime
- std::chrono::clock_cast
- std::chrono::is_am, std::chrono::is_pm, std::chrono::make12, std::chrono::make24
- std::chrono::system_clock
- std::chrono::steady_clock
- std::chrono::high_resolution_clock
- std::chrono::clock_time_conversion
- std::chrono::is_clock
- std::chrono::utc_clock
- std::chrono::tai_clock
- std::chrono::gps_clock
- std::chrono::file_clock
- std::chrono::local_t
- std::chrono::day
- std::chrono::month
- std::chrono::year
- std::chrono::weekday
- std::chrono::operator/ (日历)
- std::chrono::year_month_day
- std::chrono::year_month_day_last
- std::chrono::year_month_weekday
- std::chrono::year_month_weekday_last
- std::chrono::weekday_indexed
- std::chrono::weekday_last
- std::chrono::month_day
- std::chrono::month_day_last
- std::chrono::month_weekday
- std::chrono::month_weekday_last
- std::chrono::year_month
- std::chrono::tzdb
- std::chrono::tzdb_list
- std::chrono::get_tzdb_list, std::chrono::get_tzdb, std::chrono::remote_version, std::chrono::reload_tzdb
- std::chrono::time_zone
- std::chrono::locate_zone
- std::chrono::current_zone
- std::chrono::zoned_time
- std::chrono::time_zone_link
- std::chrono::leap_second
- std::chrono::time_of_day
- std::chrono::last_spec
- std::chrono::treat_as_floating_point
- std::literals::chrono_literals::operator""ns
- std::literals::chrono_literals::operator""y
- std::literals::chrono_literals::operator""d
- std::literals::chrono_literals::operator""s
- std::literals::chrono_literals::operator""ms
- std::literals::chrono_literals::operator""us
- std::literals::chrono_literals::operator""h
- std::literals::chrono_literals::operator""min
- std::chrono::duration_values
- std::chrono::nonexistent_local_time
- std::chrono::ambiguous_local_time
- 注释
- 字符串库
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::ctime
定义于头文件 <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 对象 |
返回值
返回指向静态空终止字符串的指针,字符串保有上述的日期和时间的文本表示。字符串可以在 std::asctime
和 std::ctime 间共享,并且可以被每次对这些函数的调用重写。
注意
ctime
返回指向静态数据的指针,而且非线程安全。另外它修改可能会为 std::gmtime 及 std::localtime 所共享的静态 std::tm 对象。 POSIX 标记此函数标为过时,并推荐用 std::strftime 替代。
对于导致字符串长于 25 字符(例如, 10000 年)的 time_t
的值, ctime
的行为可能未定义。
示例
运行此代码
#include <ctime> #include <iostream> int main() { std::time_t result = std::time(nullptr); std::cout << std::ctime(&result); }
输出:
Tue Dec 27 17:21:29 2011
参阅
转换 tm 对象为文本表示 (函数) | |
转换 tm 对象到自定义的文本表示 (函数) | |
(C++11) |
按照指定格式格式化并输出日期/时间值 (函数模板) |