strftime, wcsftime, _strftime_l, _wcsftime_l

Formatar uma cadeia de caracteres de tempo.

Sintaxe

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

Parâmetros

strDest
Cadeia de caracteres de saída.

maxsize
Tamanho do strDest buffer, medido em caracteres (char ou wchar_t).

format
Cadeia de caracteres de controle de formato.

timeptr
tm estrutura de dados.

locale
A localidade a ser usada.

Valor de retorno

strftime Devolve o número de carateres colocados strDest e wcsftime devolve o número correspondente de carateres largos.

Se o número total de caracteres, incluindo o nulo de terminação, for maior que maxsize, ambos strftime e wcsftime retornar 0 e o conteúdo de strDest são indeterminados.

O número de caracteres é strDest igual ao número de caracteres literais no format, mais quaisquer caracteres que possam ser adicionados por format meio de códigos de formatação. O nulo de terminação de uma cadeia de caracteres não é contado no valor de retorno.

Observações

As strftime funções e wcsftime formatam o valor de tm tempo de timeptr acordo com o argumento fornecido format e armazenam o resultado no buffer strDest. No máximo, maxsize os caracteres são colocados na cadeia de caracteres. Para obter uma descrição dos campos na timeptr estrutura, consulte asctime. wcsftime é o equivalente de caracteres largos de ; seu argumento de ponteiro de cadeia de caracteres aponta para uma cadeia de strftimecaracteres largos. Estas funções comportam-se de forma idêntica.

Esta função valida os seus parâmetros. Se strDest, formatou timeptr for um ponteiro nulo, ou se a estrutura de dados endereçada tm por timeptr for inválida (por exemplo, se contiver valores fora do intervalo para a hora ou data), ou se a format cadeia de caracteres contiver um código de formatação inválido, o manipulador de parâmetros inválido será invocado, conforme descrito em Validação de parâmetro. Se a execução for permitida para continuar, a função retorna 0 e define errno como EINVAL.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Mapeamentos de rotina de texto genérico

O format argumento consiste em um ou mais códigos, como em printf, os códigos de formatação são precedidos por um sinal de porcentagem (%). Os caracteres que não começam com % são copiados inalterados para strDest. A LC_TIME categoria da localidade atual afeta a formatação de saída do strftime. Para obter mais informações sobre LC_TIMEo , consulte setlocale. As strftime funções e wcsftime usam a localidade definida no momento. As _strftime_l versões e _wcsftime_l dessas funções são idênticas, exceto que elas tomam a localidade como um parâmetro e usam isso em vez da localidade definida atualmente. Para obter mais informações, consulte Locale.

As strftime funções suportam estes códigos de formatação:

Como na printf função, o sinalizador pode prefixar # qualquer código de formatação. Nesse caso, o significado do código de formato é alterado da seguinte forma.

A semana ISO 8601 e o ano baseado na semana produzidos por %V, %ge %G, usa uma semana que começa na segunda-feira. A semana 1 é a semana que contém o quarto dia de janeiro, que é a primeira semana que inclui pelo menos quatro dias do ano. Se a primeira segunda-feira do ano for a 2ª, 3ª ou 4ª, os dias anteriores fazem parte da última semana do ano anterior. Para esses dias, %V é substituído por 53, e ambos %g e %G são substituídos pelos dígitos do ano anterior.

Requerimentos

As _strftime_l funções e _wcsftime_l são específicas da Microsoft. Para obter mais informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

Veja o exemplo para time.

Ver também

Localidade
Gestão do tempo
Manipulação de cadeias de caracteres
localeconv
setlocale, _wsetlocale
strcoll funções
strxfrm, wcsxfrm, _strxfrm_l, _wcsxfrm_l