VariantTimeToSystemTime
.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 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
| Header | oleauto.h |
| Library | oleaut32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |