Comando Linux strftime

A função strftime () C , parte da biblioteca time.h , formata seqüências de caracteres para representar a data e hora do sistema.

Descrição

O strftime () função formata a hora quebrada tm de acordo com o formato de especificação de formato e coloca o resultado no carácter matriz s de tamanho máximo .

O formato especificação é um nulo – terminada cadeia e podem conter sequências de caracteres especiais chamados especificações de conversão, cada um introduzidos por um ‘ % carácter’ e terminados por algum outro carácter conhecido como um personagem especificador de conversão. Todas as outras seqüências de caracteres são seqüências de caracteres comuns.

Os caracteres das seqüências de caracteres comuns (incluindo o byte nulo ) são copiados literalmente do formato para s .

Os caracteres de conversão são substituídos da seguinte maneira.

Sintaxe

#include <time.h>
size_t strftime (char * s , size_t max , formato const char * , const struct tm * tm );

Caracteres de conversão

Algumas especificações de conversão podem ser modificadas precedendo o caractere especificador de conversão pelo modificador E ou O para indicar que um formato alternativo deve ser usado. Se o formato ou especificação alternativa não existir para o código do idioma atual, o comportamento será como se a especificação de conversão não modificada tivesse sido usada. A Especificação Única UNIX (SU) menciona % Ec , % EC , % Ex , % EX , % Ey , % EY , % Od , % Oe , % OH , % OI , % Om , % OM , % OS, % Ou , % OU , % OV , % Ow , % OW , % Oy , em que o efeito do modificador O é usar símbolos numéricos alternativos (digamos, algarismos romanos) e o do modificador E é usar um código de idioma representação alternativa dependente.

A estrutura temporal dividida tm é definida em <time.h> . Veja também ctime

Valor de retorno

A função strftime () retorna o número de bytes colocados na matriz s , sem incluir o byte nulo final, desde que a string, incluindo o byte nulo final, se ajuste. Caso contrário, ele retornará 0 e o conteúdo da matriz será indefinido. Esse comportamento se aplica desde pelo menos a libc 4.4.4; versões muito antigas da libc, como a libc 4.4.1, retornariam max se a matriz fosse muito pequena. Observe que o valor de retorno 0 não indica necessariamente um erro; por exemplo, em muitos locais % p produz uma cadeia vazia, que é equivalente a zero.

Meio Ambiente

As variáveis ​​de ambiente TZ e LC_TIME são usadas.

Notas

ISO 8601 Datas Semana % G , % g , e % V Os valores de rendimento calculado a partir do ano-base semanas definido pela norma ISO 8601. Nesse sistema, as semanas começam na segunda-feira e são numeradas de 01 , na primeira semana, até 52 ou 53 , na última semana. A semana 1 é a primeira semana em que quatro ou mais dias se enquadram no ano novo (ou, como sinônimo, a semana 01 é: a primeira semana do ano que contém uma quinta – feira ; ou a semana que tem 4 de janeiro ).

Quando três ou menos dias da primeira semana do ano novo se enquadram nesse ano, o sistema semanal ISO 8601 conta esses dias como parte da semana 53 do ano anterior. Por exemplo, 1 de janeiro de 2010 é uma sexta-feira, o que significa que apenas três dias dessa semana civil caem em 2010. Portanto, o sistema semanal ISO 8601 considera esses dias como parte da semana 53 ( % V ) do ano de 2009 ( % G ); a semana 01 do ano ISO 8601 de 2010 começa na segunda – feira, 4 de janeiro de 2010.

Glibc Notes

O Glibc fornece algumas extensões para especificações de conversão. Essas extensões não são especificadas no POSIX.1-2001, mas alguns outros sistemas fornecem recursos semelhantes. Entre o caractere ‘ % ‘ e o caractere especificador de conversão, um sinalizador opcional e a largura do campo podem ser especificados. Estes precedem os modificadores E ou O , se presentes.

Os seguintes caracteres de sinalização são permitidos:

Um especificador opcional de largura decimal pode seguir o sinalizador (possivelmente ausente). Se o tamanho natural do campo for menor que essa largura, a sequência de resultados será preenchida (à esquerda) na largura especificada.

Exemplos

"% a,% b% d% l:% M.% S"

A sequência acima formataria a data e a hora para se parecerem: sáb, 13 de julho 1: 32,59

Aqui está um exemplo de um programa que usa strftime () para interpretar essa string:

#include <time.h>
#include <stdio.h>
#include <stdlib.h>
int main (int argc, char * argv [])
{
    char outstr [200];
    time_t t;
    struct tm * tmp;
    t = tempo (NULL);
    tmp = hora local (& t);
    if (tmp == NULL) {
        perror ("localtime");
        sair (EXIT_FAILURE);
    }
     if (strftime (outstr, sizeof (outstr), argv [1], tmp) == 0)
     {
         fprintf (stderr, "strftime retornou 0");
         sair (EXIT_FAILURE);
     }
     printf ("A sequência de resultados é \"% s \ "\ n", outstr);
     exit (EXIT_SUCCESS);
}

Por exemplo, se o programa acima fosse compilado como o arquivo executável a.out , ele poderia ser usado na linha de comando da seguinte maneira:

./a.out '% m'

A sequência de resultados é "11"

./a.out '% 5m'

A sequência de resultados é "00011"

./a.out '% _5m'

A sequência de resultados é "11"

Comandos relacionados

data – gera a data e hora atuais.