std::asctime

定义于头文件 <ctime>
char* asctime( const std::tm* time_ptr );

转换给定日历时间 std::tm 为拥有下列固定 25 字符形式的文本表示: Www Mmm dd hh:mm:ss yyyy\n

*time_ptr 的任何成员在其正常范围外,则行为未定义。

time_ptr->tm_year 所指示的日历年份多于 4 位数字或小于 1000 年,则行为未定义。

函数不支持本地化,而写不能移除换行符。

函数修改静态存储,而且不是线程安全的。

目录

参数

time_ptr - 指向指定要打印时间的 std::tm 对象的指针

返回值

指向空终止字符串的指针,字符串保有日期和时间的文本表示。字符串可能在 std::asctimestd::ctime 之间共享,而且可能在每次调用任何这些函数时被重写。

注意

此函数返回指向静态数据的指针,且非线程安全。 POSIX 标记此函数为过时,并推荐使用 std::strftime 替代。

POSIX 限制了仅当输出字符串将长于 25 字符时、 timeptr->tm_wdaytimeptr->tm_mon 不在预期范围时,或 timeptr->tm_year 超过 INT_MAX-1990 时是未定义行为。

一些实现把 timeptr->tm_mday==0 处理成上个月最后一天的含义。

示例

#include <ctime>
#include <iostream>
 
int main()
{
    std::time_t result = std::time(NULL);
    std::cout << std::asctime(std::localtime(&result));
}

输出:

Mon Apr  3 20:26:26 2017

参阅

转换 time_t 对象为文本表示
(函数)
转换 tm 对象到自定义的文本表示
(函数)
(C++11)
按照指定格式格式化并输出日期/时间值
(函数模板)
asctimeC 文档

版本历史

  • (当前 | 先前 2017年10月10日 (二) 00:28Fruderica讨论 | 贡献. . (2,871字节) (-811). . (撤销)
  • 当前 | 先前 2014年10月26日 (日) 16:39P12bot讨论 | 贡献 . . (3,682字节) (0). . (Fix some translations) (撤销)
  • 当前 | 先前 2013年7月2日 (二) 07:19P12bot讨论 | 贡献 . . (3,682字节) (-78). . (Use {{lc}}. Update links. Various fixes.) (撤销)
  • 当前 | 先前 2012年11月2日 (五) 15:56P12bot讨论 | 贡献 . . (3,760字节) (+84). . (r2.7.3) (机器人添加:de, en, es, ru 去除:zh) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 09:49P12讨论 | 贡献 . . (3,676字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 06:00TranslationBot讨论 | 贡献. . (3,676字节) (-104). . (Translated from the English version using Google Translate) (撤销)
  • 当前 | 先前 2012年10月25日 (四) 13:14P12讨论 | 贡献 . . (3,780字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前 2012年10月25日 (四) 12:00TranslationBot讨论 | 贡献. . (3,780字节) (+2,937). . (Translated from the English version using Google Translate) (撤销)
  • 当前 | 先前 2012年5月4日 (五) 11:21P12bot讨论 | 贡献 . . (843字节) (+169). . (r2.7.3) (机器人添加:en, fr, it, ja, pt, tr) (撤销)
  • 当前 | 先前 2012年5月1日 (二) 03:36P12讨论 | 贡献 . . (674字节) (0). . (1个修订: Import from Dokuwiki) (撤销)
  • 当前 | 先前) 2012年5月1日 (二) 03:36P12讨论 | 贡献. . (674字节) (+674). . (Import from dokuwiki)