Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

strftime — formatar datas e horas

strftime de <time.h> formata uma struct tm num buffer. O formato determina a representação da data e da hora; reserve espaço para o carácter nulo final.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

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

strftime escreve em s um valor struct tm formatado. format contém texto e especificadores de conversão: %Y representa o ano, %m o mês, %d o dia e %% um carácter % literal. As definições de LC_TIME afetam as representações dependentes da localização.

maxsize é a capacidade do buffer, incluindo \0. O valor devolvido conta os bytes escritos, excluindo \0. Se o buffer for demasiado pequeno, a função devolve zero; não trate o seu conteúdo como uma cadeia válida. Um resultado vazio obtido com sucesso também devolve zero.

Os campos utilizados têm de conter valores válidos: tm_year conta os anos desde 1900 e tm_mon conta os meses a partir de zero. Regiões de cópia sobrepostas e especificadores de conversão não suportados causam comportamento indefinido.

Exemplos

#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;
}

Resultado

2024-02-29

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes