SystemTimeToVariantTime
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
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 |