Tue Jun 17 23:17:29 1997
В обоих случаях длина сроки равна 26 символам и включает в себя завершающие символы новой строки и '\0'.
Не во всех локалях длина строки обязательно равна 26 символам, как в стандартной локали С.
ctime() выражает указанную дату в местном времени; asctime() — в том часовом поясе, который указан в struct tm. Если последний объект был создан с помощью gmtime(), то в показателях UTC, если при помощи localtime(), то по местному времени.
size_t strftime (char *s, size_t max, char *fmt, struct tm *tp);
strftime() работает также как sprintf() для времени. Она форматирует struct tm в соответствии с форматом fmt и размещает результат в не более чем max байтах (включая завершающий символ '\0') строки s.
Подобно sprintf(), функция strftime() использует символ % для ввода управляющих последовательностей, в которые подставляются данные. Все подстановочные строки выражаются в показателях текущей локали. Однако сами управляющие последовательности являются совершенно разными. В некоторых случаях строчные буквы применяются для аббревиатур, а заглавные буквы — для полных имен. В отличие от sprintf(), здесь отсутствует опция употребления чисел в середине управляющей последовательности для ограничения длины подстановочной строки; выражение %.6А недопустимо. По аналогии с функцией sprintf(), strftime() возвращает количество символов, выведенных в буфер s. Равенство данной величины значению max означает, что объем буфера недостаточен для текущей локали; необходимо выделить больший буфер и попытаться снова.
strftime() использует те же самые подстановки, что и программа работы с датами. Ниже приводятся определения для подстановок в стандартной локали, они служат для того, чтобы помочь вам идентифицировать тип информации. В остальных локалях они могут отличаться.
%а |
Трехбуквенная аббревиатура для названия дня недели. |
%А |
Полное название дня недели. |
%b |
Трехбуквенная аббревиатура для названия месяца. |
%В |
Полное название месяца. |
%с |
Предпочтительное локальное выражение даты и времени (такое как возвращают функции ctime() и asctime()). |
%d |
День месяца в числовом виде (отсчет ведется от нуля). |
%Н |
Час дня по 24-часовому времени (отсчет ведется от нуля). |
%I |
Час дня по 12-часовому времени (отсчет ведется от нуля). |
%j |
День года (отсчет ведется от единицы). |
%m |
Месяц года (отсчет ведется от единицы). |
%М |
Минута в часе (отсчет ведется от нуля). |
%p |
Соответствующая строка для локального эквивалента выражений AM или PM. |
%S |
Секунда в минуте (отсчет ведется от нуля). |
%U |
Неделя года в числовом виде (первая неделя начинается с первого воскресенья года). |
%W |
Неделя года в числовом виде (первая неделя начинается с первого понедельника года). |
%w |
День недели в числовом виде (отсчет ведется с нуля). |
%x |
Предпочтительное локальное выражение только для даты, без времени. |
%X |
Предпочтительное локальное выражение только для времени, без даты. |
%y |
Двухзначное представление года (без столетия). Не рекомендуется использовать такой формат — это потенциальный источник "проблемы 2000-го года". |
%Y |
Полное четырехзначное числовое представление года. |
%Z |
Название стандартной аббревиатуры часовой зоны. |
%% |
Буквенный символ %. |
char *strptime(char *s, char *fmt, struct tm *tp);
Как и scanf(), функция strptime() преобразует строку в разобранный формат. Она пытается быть либеральной при интерпретации введенной строки s в соответствии с форматирующей строкой fmt. Она принимает те же самые управляющие последовательности, что и strftime(), при этом для каждого типа ввода она допускает как аббревиатуры, так и полные имена. Она не различает символы верхнего и нижнего и регистра, а также не распознает %U и %W.
Функция strptime() предусматривает несколько дополнительных управляющих последовательностей; также она интерпретирует несколько последовательностей иначе (не так, как strftime()). В последующем списке перечислены только те управляющие последовательности, которые отличаются значительно (другими словами, выходят за рамки тех изменений, на которые мы уже указывали). Числа могут предваряться нулями, но это не обязательно.
%h |
Эквивалент %b и %B. |
%с |
Считывает дату и время так, как печатает функция strftime() с форматирующей строкой %x %X. |
%С |
Считывает дату и время так, как печатает функция strftime() с форматирующей строкой %с. |
%e |
Эквивалент %d. |
%D |
Считывает дату так, как печатает функция strftime() с форматирующей строкой %m/%d/%y. |
%k |
Эквивалент %Н. |
%l |
Эквивалент %I. |
%r |
Считывает время так, как печатает функция strftime() с форматирующей строкой %I:%М:%S %p. |
%R |
Считывает время так, как печатает функция strftime() с форматирующей строкой %Н:%М. |
%T |
Считывает время так, как печатает функция strftime() с форматирующей строкой %Н:%М:%S. |
%y |
Считывает год в пределах двадцатого столетия. Допустимы значения только от 0 до 99, поскольку к ним добавляется число 1900. |
%Y |
Считывает полный год. Применяйте, по возможности, этот формат вместо %у для того, чтобы избежать "проблемы 2000-го года". |