GetDateFormat

9/8/2008

Essa função formata uma data como um seqüência de caracteres de data para uma localidade especificada. A função formata uma data especificada ou o local Data sistema.

Syntax

int GetDateFormat(
  LCID Locale, 
  DWORD dwFlags, 
  CONST SYSTEMTIME* lpDate, 
  LPCTSTR lpFormat, 
  LPTSTR lpDateStr, 
  int cchDate 
); 

Parameters

• Localidade
  [no] Valor que especifica a localidade para os quais o seqüência de caracteres de data deve ser formatado. Se lpFormat é NULL, a função formata o seqüência de caracteres de acordo com o formato de data para esta localidade. Se lpFormat não é NULL, a função usa a localidade somente para informações não especificadas no seqüência de caracteres de imagem de formato (por exemplo, dia a localidade e nomes de meses).

  Este parâmetro pode ser um identificador localidade criado pelo MAKELCID macro ou um dos seguinte valores predefinidos. A seguinte tabela mostra os valores este parâmetro pode demorar.

  Valor	Descrição
  LOCALE_SYSTEM_DEFAULT	Localidade sistema padrão.
  LOCALE_USER_DEFAULT	Localidade usuário Padrão.
  LOCALE_NEUTRAL	Localidade Language-Neutral padrão.

  Para Windows CE 1.0, Localidade é ignorado.

• dwFlags
  [no] Valor que especifica vários opções função. Se lpFormat não-NULL, este parâmetro deve ser zero.

  Se lpFormat é NULL, você pode especificar uma combinação do seguinte sinalizadores. A seguinte tabela mostra os valores este parâmetro pode demorar.

  Valor	Descrição
  DATE_SHORTDATE	Use o formato de data curto. Essa é a usar como padrão. Não pode ser usado com DATA_DATALONGA ou DATE_YEARMONTH.
  DATA_DATALONGA	Use o formato de data longo. Não pode ser usado com DATE_SHORTDATE ou DATE_YEARMONTH.
  DATE_LTRREADING	Adiciona marcas para esquerda - para - direito lendo layout. Este valor não pode ser usado com DATE_RTLREADING.
  DATE_RTLREADING	Adiciona marcas para layout de leitura right-to-left. Este valor não pode ser usado com DATE_LTRREADING.
  LOCALE_NOUSEROVERRIDE	Se a função definida, formata o seqüência de caracteres usando o sistema usar como padrão formato de data para a localidade especificada. Se não definida, os formatos função substitui o seqüência de caracteres usando qualquer usuário para formato Default–Date a localidade.
  LOCALE_USE_CP_ACP	Não suportado
  DATE_YEARMONTH	Não suportado.
  DATE_USE_ALT_CALENDAR	Usa o alternativo Calendário, se houver, para formato de seqüência de caracteres de data. Se este sinalizador estiver definido, a função usa o formato padrão para o alternativo especificado Calendário, em vez de usar qualquer usuário substitui. Substitui o usuário será usado somente no evento que não há nenhuma formato padrão para o alternativo especificado Calendário.

• lpDate
  [no] Ponteiro para um SYSTEMTIME estrutura que contém as informações de data seja formatado. Se esse ponteiro é NULL, a função usa o atual local Data sistema.

• lpFormat
  [no] Ponteiro para uma seqüência de caracteres de imagem formato usar para forma a seqüência de caracteres de data. Se lpFormat é NULL, a função usa o formato de data da localidade especificada.

  Use o seguinte elementos para construção um seqüência de caracteres de imagem formato. Se você usar espaços para separar os elementos no seqüência de caracteres formato, estas serão espaços aparecem na mesma localidade no seqüência de caracteres de saída. As letras devem ser em maiúscula ou minúsculas conforme a tabela (por exemplo, "mm" Não "mm"). Caracteres em seqüência de caracteres o formato que são colocados entre aspas simples serão exibidos na mesma localidade e inalterado no seqüência de caracteres de saída.

  Valor	Descrição
  D	Dia do mês como dígitos com nenhuma zero à esquerda para único-dias dígito.
  Dd	Dia do mês como dígitos com zero à esquerda de única-dias dígito.
  Ddd	Dia da semana como um três-abreviação letra. A função usa o valor LOCALE_SABBREVDAYNAME associado com a localidade especificada.
  Dddd	Dia da semana como seu nome completo. A função usa o valor LOCALE_SDAYNAME associado com a localidade especificada.
  M	Mês como dígitos com nenhuma zero à esquerda para único-meses dígito.
  MM	Mês como dígitos com zero à esquerda de única-meses dígito.
  MMM	Mês como um três-abreviação letra. A função usa o valor LOCALE_SABBREVMONTHNAME associado com a localidade especificada.
  MMMM	Mês como seu nome completo. A função usa o valor LOCALE_SMONTHNAME associado com a localidade especificada.
  y	Ano como último dois dígitos, com um zero à esquerda para menor que 10 anos. O mesmo formato como "YY".
  aa	Ano como último dois dígitos, com um zero à esquerda para menor que 10 anos.
  aaaa	Ano representado por completo quatro dígitos.
  gg	Seqüência de caracteres Period/era. A função usa o valor CAL_SERASTRING associado com a localidade especificada. Este elemento é ignorado se a data para ser formatado não possui um associado era ou período seqüência de caracteres.

  De exemplo, para get a seqüência de caracteres de data

  "Qua, 31 de ago de 94"

  Use a seguinte imagem seqüência de caracteres:

  " ddd ',' Aa dd MMM"

• lpDateStr
  [out] Ponteiro para uma reserva que recebe o formatado Data seqüência de caracteres.

• cchDate
  [no] Tamanho, em caracteres, da lpDateStr reserva. Se cchDate for zero, a função retorna o número de caracteres exigido para armazenar o formatado Data seqüência de caracteres, e a reserva apontado pelo lpDateStr não é usado.

Return Value

O número de caracteres gravadas a lpDateStr reserva, ou, se a cchDate parâmetro é zero, o número de caracteres exigido para manter o formatado seqüência de caracteres de data indica sucesso. A contagem inclui o NULL terminação. Zero indica falha. Para informações de erro estendidas get, chamar o GetLastError função. A seguinte tabela mostra possíveis valores de retorno para o GetLastError função.

Valor	Descrição
ERROR_INSUFFICIENT_BUFFER	A área de dados transferida para uma chamada do sistema é muito pequena.
ERROR_INVALID_FLAGS	Os sinalizadores são inválido.
ERROR_INVALID_PARAMETER	O parâmetro está incorreto.

Remarks

O nome dia, nome abreviado dia, mês Nome e Nome de mês abreviado estão todos localizados com base no identificador de localidade fornecido.

O Localidade parâmetro será ignorado e a localidade sistema sempre é usada. O Localidade parâmetro deve ser definido como LOCALE_SYSTEM_DEFAULT para garantir compatibilidade com versões futuras do Windows Embedded CE.

A data valores na SYSTEMTIME estrutura apontada pelo lpDate deve ser válido. A função verifica cada os seguinte valores de data: Ano, Mês e Dia. Se o dia da semana especificado na wDayofWeek membro de SYSTEMTIME está incorreta, a função usa o valor correto e não retorna nenhum erro. Se qualquer um dos outros valores de data são fora de intervalo correto, o função falhar e define o último erro para ERROR_INVALID_PARAMETER. Se você tentar get um ano usando um dígito GetDateFormat(LOCALE_USER_DEFAULT,0,NULL,TEXT("y"), ach, 50), a função retorna uma duas-ano dígito.

A função ignora as partes do tempo de SYSTEMTIME estrutura apontada pelo lpDate: wHour, wMinute, wSecond, e wMilliseconds.

As opções sinalizador DATE_SHORTDATE e DATA_DATALONGA são mutuamente exclusivas. Se nenhum for especificado um nem lpFormat é NULL, DATE_SHORTDATE é a usar como padrão.

Windows CE 2.10 e posterior, usar como padrão DATE_SHORTDATE formatos para que não seja dos EUA Inglês localidades que incluem os quatro - ano dígito são adicionados. A seguinte tabela mostra os formatos.

Localidade	Formato de data
Reino Unido	dd/mm/aaaa
Canadá	dd/mm/aaaa
Nova Zelândia	dd/mm/aaaa
Irlanda	dd/mm/aaaa
África do Sul	dd/mm/aaaa
Caribe	Dd/mm/aaaa
Belize	dd/mm/aaaa
Trinidad	dd/mm/aaaa

Há erros são retornados para um incorreto formato seqüência de caracteres. A função simplesmente forma a melhor seqüência de caracteres de data que ele pode. Para exemplo, as imagens somente ano que são válido são L "yyyy" e L "YY" (o 'L' Indica um Unicode (16-bit caracteres) seqüência de caracteres). Se "y" L é passado, a função assume L "YY". Se "yyy" L é passado, a função assume L "yyyy". Se mais de 4 data (L "dddd") ou figuras 4 mês (L "mmmm") são passadas em, em seguida, a função padrão L "dddd" Ou L "mmmm".

Qualquer texto que deve permanecer em sua forma exata na seqüência de caracteres a data deve ser entre único aspas na imagem formato de data. O aspas simples também pode ser usado como um caractere de escape para permitir que o aspas simples para ser exibido no seqüência de caracteres de data. No entanto, o seqüência de escape deve ser colocada dentro duas aspas simples. De exemplo, para exibir a data como "May '93", o seqüência de caracteres formato seria: L "mmmm '' '' aa" As aspas simples e o sobrenome são as aspas delimitador. As aspas segunda e terceiro única são o seqüência de escape permitir que o aspas simples a ser exibido antes do século.

Requirements

Header	winnls.h
Library	Coreloc.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

GetTimeFormat
MAKELCID

Other Resources

SYSTEMTIME