strftime() — 날짜/시간을 스트링으로 변환

형식

#include <time.h>
size_t strftime(char *s, size_t maxsize, const char *format,
                   const struct tm *timeptr);

언어 레벨

ANSI

스레드세이프

예

로케일 감지

이 함수의 작동은 현재 로케일의 LC_CTYPE, LC_TIME, LC_TOD 범주로 영향을 받을 수 있습니다. 자세한 정보는 CCSID 및 로케일 이해의 내용을 참조하십시오.

설명

strftime() 함수는 format 으로 가리키는 스트링에서 제어하는 대로, s로 가리키는 배열에 바이트를 배치합니다. 형식 스트링은 0개 이상의 변환 스펙 및 보통 문자로 구성됩니다. 변환 스펙은 변환 작동을 판별하는 종료 변환 문자 및 % 문자로 구성됩니다. 종료 널 바이트 및 멀티바이트 문자를 포함하여 모든 보통 문자는 배열로 변경되지 않고 복사됩니다. 겹치는 오브젝트 사이에서 복사가 수행되면 작동은 정의되지 않습니다. maxsize 이하의 바이트가 배열에 배치됩니다. 적절한 문자는 timeptr 및 현재 로케일에 저장된 값으로 가리키는 구조에 포함된 값으로 판별됩니다.

각 표준 변환 스펙은 다음 표에서 설명한 대로 적절한 문자로 대체됩니다.

수정된 변환 지정자

일부 변환 지정자는 대체 형식 또는 스펙을 사용해야 함을 표시하도록 E 또는 0 수정자 문자로 수정할 수 있습니다. 또는 수정되지 않은 변환 지정자가 정상적으로 사용하는 항목 대신 스펙을 사용해야 합니다. 수정된 변환 지정자가 사용할 수 없는 현재 로케일의 필드를 사용하는 경우 작동은 수정하지 않은 변환 스펙을 사용한 경우와 같습니다. 예를 들어, era 스트링이 빈 스트링 ""인 경우(즉, 스트링을 사용할 수 없음) %EY는 %Y와 같이 작동합니다.

리턴값

종료 널 바이트를 포함하는 총 결과 바이트 수가 maxsize 이하인 경우 strftime()은 종료 널 바이트를 포함하지 않고 s로 가리키는 배열에 배치된 바이트 수를 리턴합니다. 그렇지 않으면 0이 리턴되고 배열의 컨텐츠는 불확실합니다.

변환 오류가 발생하면 errno가 ECONVERT로 설정될 수 있습니다.

예

#include <stdio.h>
#include <time.h>
 
int main(void)
{
     char s[100];
     int rc;
     time_t temp;
     struct tm *timeptr;

     temp = time(NULL);
     timeptr = localtime(&temp);

     rc = strftime(s,sizeof(s),"Today is %A, %b %d.\nTime:  %r", timeptr);
     printf("%d characters written.\n%s\n",rc,s);

     return 0;
}

/*************************************************
     The output should be similar to:
     46 characters written
     Today is Wednesday, Oct 24.
     Time:  01:01:15 PM
************************************************************/

관련 정보