Compartilhar via


SystemTimeToVariantTime

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

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

Syntax

int SystemTimeToVariantTime(
  SYSTEMTIME lpSystemTime, 
  double* pvtime 
); 

Parameters

  • lpSystemTime
    [no] Ponteiro longo para o hora do sistema.
  • pvtime
    [out] Void ponteiro para a variante retornada tempo.

Return Value

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

Remarks

Uma variante tempo é armazenado como um 8-byte (valor realduplo), 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.

A variante tempo resolve para um segundo. Qualquer milissegundos na entrada data são ignorados.

O SYSTEMTIME estrutura é útil para a seguinte 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 usando decodificação bit.
  • O National Data Support dados e formatação tempo funções GetDateFormat e GetTimeFormat Tirar um SYSTEMTIME valor como entrada. Para obter mais informações, consulte o Referência do Programador do Win32 Na Win32 SDK.
  • É a formato de dados Time/Date Win32 usar como padrão com suporte, Microsoft Windows NT® e Windows 95.

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

Requirements

Header oleauto.h
Library oleaut32.lib
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Automation Functions

Other Resources

SYSTEMTIME
GetDateFormat
GetTimeFormat