База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / C

strftime — форматиране на дата и час

strftime от <time.h> форматира struct tm в буфер. Форматът определя представянето на датата и часа; осигурете място за завършващия нулев знак.

Версия: C23; repository compiler flag, production runtime not attested

Синтаксис

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

strftime записва форматирана стойност struct tm в s. format съдържа текст и спецификатори за преобразуване: %Y означава година, %m месец, %d ден, а %% — буквален знак %. Настройките на LC_TIME влияят върху представянията, зависещи от локалните настройки.

maxsize е капацитетът на буфера, включително \0. Върнатата стойност отчита записаните байтове без \0. Ако буферът е твърде малък, функцията връща нула; не третирайте съдържанието му като валиден низ. Успешен празен резултат също връща нула.

Използваните полета трябва да съдържат валидни стойности: tm_year брои годините от 1900 г., а tm_mon брои месеците от нула. Припокриващи се области за копиране и неподдържани спецификатори за преобразуване водят до неопределено поведение.

Примери

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

int main(void)
{
    const struct tm date = {
        .tm_year = 2024 - 1900,
        .tm_mon = 2 - 1,
        .tm_mday = 29
    };
    char text[32];
    if (strftime(text, sizeof text, "%Y-%m-%d", &date) == 0) {
        return 1;
    }
    puts(text);
    return 0;
}

Резултат

2024-02-29

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници