STRFTIME, wcsftime, _strftime_l, _wcsftime_l

Artigo
08/25/2010

Formate uma seqüência de time.

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
Seqüência de saída.
maxsize
dimensionar de strDest buffer.
format
Seqüência de caracteres de controle de formato.
timeptr
tm estrutura de dados.
locale
A localidade para usar.

Valor de retorno

strftime Retorna o número de caracteres colocados em strDest e wcsftime Retorna o número correspondente de caracteres largos.

Se o número total de caracteres, incluindo a terminação nulo, é mais de maxsize, ambos strftime e wcsftime retornar 0 e o Sumário de strDest são indeterminados.

O número de caracteres em strDest for igual ao número de caracteres literal format Assim sistema autônomo quaisquer caracteres que podem ser adicionados a format por meio de códigos de formatação. A terminação nula de uma seqüência de caracteres não for contabilizada no valor retornado.

Comentários

The strftime e wcsftime funções de formato de tm valor de time em timeptr de acordo com a fornecido format argumento e o resultado no buffer de armazenamento strDest*.* No máximo, maxsize caracteres são colocados na seqüência de caracteres. Para obter uma descrição dos campos a timeptr estrutura, consulte asctime.wcsftime é o equivalente a caractere largo strftime; aponta seu argumento do ponteiro da seqüência de caracteres em uma seqüência de caracteres largos. Essas funções se comportam exatamente caso contrário.

Observação:
Em versões anteriores Visual C++ 2005, the documentation described the format parameter of wcsftime as having the data type const wchar_t , but the actual implementation of the format data type was const char .In Visual C++ 2005, the implementation of the format data type has been updated to reflect the previous and current documentation, that is, const wchar_t *.

Esta função valida os parâmetros.If strDest, format, ortimeptr is a null pointer, or if the tm data structure addressed by timeptr is invalid (for example, if it contains out of range values for the time or date), or if the format string contains an invalid formatting code, the invalid parameter handler is invoked, as described in Validação de parâmetro.Se a execução for permitida para continuar, a função retorna 0 e define errno para EINVAL.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H	_UNICODE & _MBCS não definido	_MBCS definido	_UNICODE definido
_tcsftime	strftime	strftime	wcsftime

The format argumento consiste de um ou mais códigos; sistema autônomo em printf, sistema autônomo códigos de formatação são precedidos por um sinal de porcentagem (%). Caracteres que não começam com % são copiados inalterada para strDest*.* The LC_TIME categoria da localidade corrente afeta a formatação de saída do strftime.(For more information on LC_TIME, consulte setlocale.) As funções sem o _l usar o sufixo atualmente definido localidade. sistema autônomo versões dessas funções com o _l sufixo são idênticas exceto que eles tenham a localidade sistema autônomo um parâmetro e use-o em vez do atualmente conjunto localidade. For more information, see Localidade.

Os códigos de formatação de strftime estão listados a seguir:

%a
Nome abreviado do dia da semana
%A
Nome completo do dia da semana
%b
Nome do mês abreviado
%B
Nome completo do mês
%c
Representação de data e time apropriada para localidade
%d
Dia do mês sistema autônomo número decimal (01 – 31)
%H
A hora em formato de 24 horas (00 – 23)
%I
Hora em formato de 12 horas (01 – 12)
%j
Dia do ano sistema autônomo número decimal (001 – 366)
%m
Mês sistema autônomo número decimal (01 – 12)
%M
Minutos sistema autônomo número decimal (00 – 59)
%p
AM/PM do local corrente.indicador de relógio de 12 horas
%S
Segundo, sistema autônomo o número decimal (00 – 59)
%U
Semana do ano sistema autônomo número decimal, com o domingo sistema autônomo o primeiro dia da semana (00 – 53)
%w
Dia da semana sistema autônomo número decimal (0 – 6; domingo é 0)
%W
Semana do ano sistema autônomo número decimal, com a segunda sistema autônomo primeiro dia da semana (00 – 53)
%x
Representação de data para a localidade corrente
%X
Representação de time para localidade corrente
%y
Ano sem século, sistema autônomo o número decimal (00 – 99)
%Y
Ano com século, sistema autônomo o número decimal
%z, %Z
O nome do fuso horário ou horário zona abreviação, de acordo com as configurações do registro; nenhum caractere se for de fuso horário desconhecido
%%
Sinal de porcentagem

sistema autônomo no printf função, o # sinalizar pode prefixo qualquer código de formatação. Nesse caso, o significado do código de formato é alterado da seguinte maneira.

Código de formato	Significado
%#a, %#A, %#b, %#B, %#p, %#X, %#z, %#Z, %#%	# sinalizar será ignorado.
%#c	Longa data e time da representação, apropriada para a localidade corrente.Por exemplo: "Terça-feira, 14 de março de 1995, 12:41:29".
%#x	Representação de data por extenso, apropriada para a localidade corrente.Por exemplo: "Terça-feira 14 de março de 1995".
%#d, %#H, %#I, %#j, %#m, %#M, %#S, %#U, %#w, %#W, %#y, %#Y	Remova zeros entrelinhamento (se houver).