Hàm strftime() trong thư viện C chuẩn

Định nghĩa hàm strftime() trong C

Hàm size_t strftime(char *str, size_t maxsize, const char *format, const struct tm *timeptr) định dạng thời gian được biểu diễn trong cấu trúc timeptr theo các qui tắc định dạng được định nghĩa trong format và được lưu trữ vào trong str.

Khai báo hàm strftime() trong C

Dưới đây là phần khai báo cho strftime() trong C:

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

Tham số

• str -- Đây là con trỏ tới mảng đích, nơi mà chuỗi kết quả được sao chép.
• maxsize -- Đây là số ký tự tối đa để được sao chép tới str.
• format -- Đây là chuỗi chứa bất cứ tổ hợp nào của các ký tự thông thường và các format specifier đặc biệt. Những format specifier này được thay thế bởi hàm này bởi các giá trị tương ứng để biểu diễn thời gian được xác định trong tm. Các format specifier là:

timeptr -- là con trỏ trỏ tới giá trị time_t biểu diễn một calendar time, mà được chia nhỏ thành các thành phần với cấu trúc:

struct tm {
   int tm_sec;         /* biểu diễn giây, từ 0 tới 59 */
   int tm_min;         /* biểu diễn phút, từ 0 tới 59 */
   int tm_hour;        /* biểu diễn giờ, từ 0 tới 23 */
   int tm_mday;        /* biểu diễn ngày của tháng, từ 1 tới 31 */
   int tm_mon;         /* biểu diễn tháng, từ 0 tới 11 */
   int tm_year;        /* biểu diễn năm, bắt đầu từ 1900 */
   int tm_wday;        /* ngày trong tuần, từ 0 tới 6 */
   int tm_yday;        /* ngày trong năm, từ 0 tới 365 */
   int tm_isdst;       /* biểu diễn Daylight Saving Time */
};

Trả về giá trị

Nếu chuỗi kết quả có kích cỡ nhỏ hơn kích cỡ các ký tự (bao gồm ký tự null kết thúc), thì toàn bộ ký tự được sao chép tới str (không bao gồm ký tự null kết thúc) được trả về. Nếu không, hàm trả về 0.

Ví dụ minh họa cách sử dụng của strftime() trong C:

#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("Date & time da dinh dang theo ham strftime la: \n|%s|\n", buffer );

   return(0);
}

Biên dịch và chạy chương trình C trên sẽ cho kết quả:

Xem thêm:

Thư viện C chuẩn: