VariantTimeToSystemTime

9/8/2008

Essa função converte a variante representação de tempo para valores hora do sistema.

Syntax

int VariantTimeToSystemTime(
  double vtime, 
  LPSYSTEMTIME lpSystemTime 
); 

Parameters

• vtime
  [no] Especifica a variante tempo que será convertido.

• lpSystemTime
  [out] Ponteiro longo para a localidade onde o tempo convertido está armazenado.

Return Value

Um valor non-zero se a variante com êxito foi convertido para um hora do sistema, zero caso contrário.

Remarks

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Uma variante tempo é armazenado como um 8-valor real byte (duplo), que representa uma data entre, 1 de janeiro de 1753 e 31 de dezembro de 2078, inclusive.

O valor 2.0 representa 1 de janeiro de 1900; 3.0 representa 2 de janeiro de 1900 e assim por diante.

Adicionando 1 a incrementos de valor de data por um dia. O parte fracionária do valor representa o tempo de dia. Portanto, 2.5 representa meio-dia em 1 º de janeiro de 1900; 3.25 representa 6: 00 em 2 de janeiro de 1900 e assim por diante.

Números negativos representam as datas anteriores a 30 de dezembro de 1899.

Usando o SYSTEMTIME estrutura é útil por estas razões:

• Ele abrange todos os períodos de data/hora. Data MS-DOS/tempo é limitado a representando somente as datas entre 1/1/1980 e 31/12/2107.
• A data/tempo elementos são todos facilmente acessível sem precisar fazer decodificação bit.
• O National Language Support dados e formatação tempo funções GetDateFormat e GetTimeFormat Tirar um SYSTEMTIME valor como entrada.
• Ele é o tempo Win32 usar como padrão e formato de dados de data com suporte, Windows NT e Windows 95.

Requirements

See Also

Reference

Automation Functions

Other Resources

SYSTEMTIME
GetDateFormat
GetTimeFormat