strptime - Convert to Formatted Date and Time

Syntax

#include <time.h>
char *strptime(const char *buf, const char *fmt, struct tm *tm);

strptime uses the format specified by fmt to convert the character string pointed to by buf to values that are stored in the structure pointed to by tm.

The *fmt is composed of zero or more directives. Each directive is composed of one of the following:

One or more white-space characters (as specified by the isspace function)
An ordinary character (neither % nor a white-space character)
A conversion specifier.

Each conversion specifier consists of a % character followed by a conversion character that specifies the replacement required. There must be white-space or other non-alphanumeric characters between any two conversion specifiers.

For a directive composed of white-space characters, strptime scans input up to the first character that is not white space (which remains unscanned), or until no more characters can be scanned.

For a directive that is an ordinary character, strptime scans the next character from the buffer. If the scanned character differs from the one comprising the directive, the directive fails and the differing and subsequent characters remain unscanned.

For a series of directives composed of %n, %t, white-space characters, or any combination, strptime scans up to the first character that is not white space (which remains unscanned), or until no more characters can be scanned.

For any other conversion specification, strptime scans characters until a character matching the next directive is scanned, or until no more characters can be scanned. It then compares these characters, excepting the one matching the next directive, to the locale values associated with the conversion specifier. If a match is found, strptime sets the appropriate tm structure members to values corresponding to the locale information. Case is ignored when items in buf are matched, such as month or weekday names. If no match is found, strptime fails and no more characters are scanned.

The following tables list the conversion specifiers for strptime. кФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГSpecifier ГMeaning Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %a Г Day of week, using locale's abbreviated or full Г
Г Г weekday name. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %A Г Day of week, using locale's abbreviated or full Г
Г Г weekday name. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %b Г Month, using locale's abbreviated or full month Г
Г Г name. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %B Г Month, using locale's abbreviated or full month Г
Г Г name. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %c Г Date and time, using locale's date and time. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %C Г Century number (year divided by 100 and truncated to Г
Г Г an integer) Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %d Г Day of the month (1-31; leading zeros permitted but Г
Г Г not required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %D Г Date as %m/%d/%y. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %e Г Day of the month (1-31; leading zeros permitted but Г
Г Г not required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %h Г Month, using locale's abbreviated or full month Г
Г Г name. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %H Г Hour (0-23; leading zeros permitted but not Г
Г Г required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %I Г Hour (0-12; leading zeros permitted but not Г
Г Г required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %j Г Day number of the year (001-366). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %m Г Month number (1-12; leading zeros permitted but not Г
Г Г required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %M Г Minute (0-59; leading zeros permitted but not Г
Г Г required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %n Г Any white space. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %p Г Locale's equivalent of AM or PM. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %r Г Time as %I:%M:%S a.m. or %I:%M:%S p.m. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %R Г Time in 24 hour notation (%H%M) Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %S Г Seconds (0-61; leading zeros permitted but not Г
Г Г required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %t Г Tab character. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %T Г Time as %H:%M:%S. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %U Г Week number of the year (0-53; where Sunday is the Г
Г Г first day of the week; leading zeros permitted but Г
Г Г not required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %w Г Weekday (0-6; where Sunday is 0; leading zeros per- Г
Г Г mitted but not required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %W Г Week number of the year (0-53; where Monday is the Г
Г Г first day of the week; leading zeros permitted but Г
Г Г not required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %x Г Date, using locale's date format. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %X Г Time, using locale's time format. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %y Г Year within century (0-99; leading zeros permitted Г
Г Г but not required). Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Y Г Year, including century. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Z Г Time zone name Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %% Г Replace with %. Г
РФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Some directives can be modified by the E or O modifier characters to indicate that an alternative format or specification should be used rather than the one normally used by the unmodified directive. If the alternative format or specification does not exist in the current locale, the behavior will be as if the unmodified directive were used. кФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФП
Г SpecifierГ Meaning Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ec Г Replace with the locale's alternative date and time Г
Г Г representation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %EC Г Replace with the name of the base year (period) in Г
Г Г the locale's alternative representation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ex Г Replace with the locale's alternative date represen- Г
Г Г tation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %EX Г Replace with the locale's alternative time represen- Г
Г Г tation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ey Г Replace with the offset from %EC (year only) in the Г
Г Г locale's alternative representation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %EY Г Replace with the full alternative year represen- Г
Г Г tation. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Od Г Replace with the day of month, using the locale's Г
Г Г alternative numeric symbols, filled as needed with Г
Г Г leading zeroes if there is any alternative symbol Г
Г Г for zero; otherwise, fill with leading spaces. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Oe Г Replace with the day of the month, using the Г
Г Г locale's alternative numeric symbols, filled as Г
Г Г needed with leading spaces. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OH Г Replace with the hour (24-hour clock), using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OI Г Replace with the hour (12-hour clock), using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Om Г Replace with the month, using the locale's alterna- Г
Г Г tive numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OM Г Replace with the minutes, using the locale's alter- Г
Г Г native numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OS Г Replace with the seconds, using the locale's alter- Г
Г Г native numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OU Г Replace with the week number of the year (Sunday as Г
Г Г the first day of the week, rules corresponding to Г
Г Г %U), using the locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Ow Г Replace with the weekday (Sunday=0), using the Г
Г Г locale's alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %OW Г Replace with the week number of the year (Monday as Г
Г Г the first day of the week), using the locale's Г
Г Г alternative numeric symbols. Г
УФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г %Oy Г Replace with the year (offset from %C) in the Г
Г Г locale's alternative representation, using the Г
Г Г locale's alternative numeric symbols. Г
РФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

If successful, strptime returns a pointer to the character following the last character parsed. Otherwise, a null pointer is returned.

This example uses strptime to convert a string to the structure xmas, then prints the contents of the structure.

#include <time.h>
#include <stdio.h>
#include <stdlib.h>

int main(void)
{
   struct tm xmas;

   if (NULL == strptime("12/25/94 12:00:01", "%D %T", &xmas)) {
      printf("strptime() failed.\n");
      exit(EXIT_FAILURE);
   }
   printf("tm_sec  = %3d\n", xmas.tm_sec );
   printf("tm_min  = %3d\n", xmas.tm_min );
   printf("tm_hour = %3d\n", xmas.tm_hour);
   printf("tm_mday = %3d\n", xmas.tm_mday);
   printf("tm_mon  = %3d\n", xmas.tm_mon );
   printf("tm_year = %3d\n", xmas.tm_year);
   return 0;

   /****************************************************************************
      The output should be similar to :

      tm_sec  =   1
      tm_min  =   0
      tm_hour =  12
      tm_mday =  25
      tm_mon  =  11
      tm_year =  94
   ****************************************************************************/
}

[Back]

[Next]