您的位置:首页 > 编程语言 > C语言/C++

C语言时间处理函数strftime

2012-03-30 18:45 399 查看
很方便实用的函数,mark一下~

function


strftime

<ctime>

size_t strftime ( char * ptr, size_t maxsize, const char * format, const struct tm * timeptr );


Format time to string
Copies into ptr the content of format,
expanding its format tags into the corresponding values as specified by timeptr, with a limit ofmaxsize characters.


Parameters

ptrPointer to the destination array where the resulting C string is copied.maxsizeMaximum number of characters to be copied to ptr.formatC string containing any combination of regular characters and special format specifiers. These format specifiers are replaced by the function to the corresponding values to represent the time specified in timeptr. They all begin with a percentage
(%) sign, and are:

specifierReplaced byExample
%aAbbreviated weekday name *Thu
%AFull weekday name *Thursday
%bAbbreviated month name *Aug
%BFull month name *August
%cDate and time representation *Thu Aug 23 14:55:02 2001
%dDay of the month (01-31)23
%HHour in 24h format (00-23)14
%IHour in 12h format (01-12)02
%jDay of the year (001-366)235
%mMonth as a decimal number (01-12)08
%MMinute (00-59)55
%pAM or PM designationPM
%SSecond (00-61)02
%UWeek number with the first Sunday as the first day of week one (00-53)33
%wWeekday as a decimal number with Sunday as 0 (0-6)4
%WWeek number with the first Monday as the first day of week one (00-53)34
%xDate representation *08/23/01
%XTime representation *14:55:02
%yYear, last two digits (00-99)01
%YYear2001
%ZTimezone name or abbreviationCDT
%%A % sign%
* The specifiers whose description is marked with an asterisk (*) are locale-dependent.

timeptrPointer to a tm structure that contains a calendar time broken down into its components (see tm).


Return Value

If the resulting C string fits in less than maxsize characters
including the terminating null-character, the total number of characters copied to ptr (not including the terminating null-character)
is returned.

Otherwise, zero is returned and the contents of the array are indeterminate.


Portability

This description corresponds to the C++ version of this function (which is the same as in the ISO-C Standard of 1990). C compilers may support additional specifiers and modifiers for the format parameter
of this function, which are not described here.


Example

[code]1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

[code]/* strftime example */
#include <stdio.h>
#include <time.h>

int main ()
{
  time_t rawtime;
  struct tm * timeinfo;
  char buffer [80];

  time ( &rawtime );
  timeinfo = localtime ( &rawtime );

  strftime (buffer,80,"Now it's %I:%M%p.",timeinfo);
  puts (buffer);
  
  return 0;
}

Example output:

Now it's 03:21PM.

内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: