C 庫函數– strftime()
描述
C庫函數size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)根據format中定義的格式化規則,格式化結構timeptr表示的時間,並把它存儲在str中。
聲明
下面是strftime() 函數的聲明。
size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr)
參數
- str --這是指向目標數組的指針,用來複製產生的C字符串。
- maxsize --這是被複製到str的最大字符數。
- format --這是C字符串,包含了普通字符和特殊格式說明符的任何組合。這些格式說明符由函數替換為表示tm 中所指定時間的相對應值。 格式說明符是:
说明符 | 替换为 | 实例 |
---|---|---|
%a | 缩写的星期几名称 | Sun |
%A | 完整的星期几名称 | Sunday |
%b | 缩写的月份名称 | Mar |
%B | 完整的月份名称 | March |
%c | 日期和时间表示法 | Sun Aug 19 02:56:02 2012 |
%d | 一月中的第几天(01-31) | 19 |
%H | 24 小时格式的小时(00-23) | 14 |
%I | 12 小时格式的小时(01-12) | 05 |
%j | 一年中的第几天(001-366) | 231 |
%m | 十进制数表示的月份(01-12) | 08 |
%M | 分(00-59) | 55 |
%p | AM 或 PM 名称 | PM |
%S | 秒(00-61) | 02 |
%U | 一年中的第几周,以第一个星期日作为第一周的第一天(00-53) | 33 |
%w | 十进制数表示的星期几,星期日表示为 0(0-6) | 4 |
%W | 一年中的第几周,以第一个星期一作为第一周的第一天(00-53) | 34 |
%x | 日期表示法 | 08/19/12 |
%X | 时间表示法 | 02:50:06 |
%y | 年份,最后两个数字(00-99) | 01 |
%Y | 年份 | 2012 |
%Z | 时区的名称或缩写 | CDT |
%% | 一个 % 符号 | % |
- timeptr --這是指向tm結構的指針,該結構包含了一個唄分解為以下各部分的日曆時間:
struct tm { int tm_sec; /* 秒,范围从 0 到 59 */ int tm_min; /* 分,范围从 0 到 59 */ int tm_hour; /* 小时,范围从 0 到 23 */ int tm_mday; /* 一月中的第几天,范围从 1 到 31 */ int tm_mon; /* 月份,范围从 0 到 11 */ int tm_year; /* 自 1900 起的年数 */ int tm_wday; /* 一周中的第几天,范围从 0 到 6 */ int tm_yday; /* 一年中的第几天,范围从 0 到 365 */ int tm_isdst; /* 夏令时 */ };
返回值
如果產生的C 字符串小於size 個字符(包括空結束字符),則會返回複製到str 中的字符總數(不包括空結束字符),否則返回零。
實例
下面的實例演示了strftime() 函數的用法。
#include <stdio.h> #include <time.h> int main () { time_t rawtime; struct tm *info; char buffer[80]; time( &rawtime ); info = localtime( &rawtime ); strftime(buffer,80,"%x - %I:%M%p", info); printf("格式化的日期 & 时间 : |%s|\n", buffer ); return(0); }
讓我們編譯並運行上面的程序,這將產生以下結果:
格式化的日期 & 时间 : |08/23/12 - 12:40AM|