Funzione SHFormatDateTimeW (shlwapi.h)
[ SHFormatDateTime è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]
Produce una rappresentazione di stringa di un'ora specificata come struttura FILETIME
Sintassi
int SHFormatDateTimeW(
[in] const FILETIME *pft,
[in, out, optional] DWORD *pdwFlags,
[out] LPWSTR pszBuf,
UINT cchBuf
);
Parametri
[in] pft
Tipo: const FILETIME UNALIGNED*
Puntatore alla struttura
[in, out, optional] pdwFlags
Tipo: DWORD*
Puntatore a un valore DWORD che contiene flag bit per bit che specificano il formato di data e ora.
Quando si chiama la funzione, è possibile combinare zero o più flag seguenti, con eccezioni come indicato. È anche possibile impostare questo parametro su NULL, nel qual caso la funzione presuppone che sia impostato il flag FDTF_DEFAULT.
FDTF_SHORTTIME (0x00000001)
0x00000001. Formatta l'ora del giorno come specificato dalla Opzioni internazionali e della lingua'applicazione nel Pannello di controllo, ma senza secondi. Questo flag non può essere combinato con FDTF_LONGTIME.
Il breve intervallo di tempo è stato formattato correttamente.
FDTF_SHORTDATE (0x00000002)
0x00000002. Formatta la data come specificato dal formato di data breve nel opzioni internazionali e linguistiche'applicazione nel Pannello di controllo. Questo flag non può essere combinato con FDTF_LONGDATE.
La data breve è stata formattata correttamente.
FDTF_DEFAULT
Equivalente a FDTF_SHORTDATE | FDTF_SHORTTIME.
FDTF_LONGDATE (0x00000004)
0x00000004. Formatta la data come specificato dal formato di data estesa nel opzioni internazionali e linguistiche'applicazione nel Pannello di controllo. Questo flag non può essere combinato con FDTF_SHORTDATE.
La data estesa è stata formattata correttamente.
FDTF_LONGTIME (0x00000008)
0x00000008. Formatta l'ora del giorno come specificato dalla opzioni internazionali e linguistiche'applicazione nel Pannello di controllo, inclusi i secondi. Questo flag non può essere combinato con FDTF_SHORTTIME.
La formattazione dell'intervallo di tempo è stata completata.
FDTF_RELATIVE (0x00000010)
0x00000010. Se il flag FDTF_LONGDATE è impostato e la data nella struttura FILETIME
La notazione relativa è stata usata per la data.
FDTF_LTRDATE (0x00000100)
0x00000100. Aggiunge segni per il layout di lettura da sinistra a destra. Questo flag non può essere combinato con FDTF_RTLDATE.
FDTF_RTLDATE (0x00000200)
0x00000200. Aggiunge segni per il layout di lettura da destra a sinistra. Questo flag non può essere combinato con FDTF_LTRDATE.
FDTF_NOAUTOREADINGORDER (0x00000400)
0x00000400. Non vengono inseriti contrassegni di ordine di lettura. In genere, in assenza del flag FDTF_LTRDATE o FDTF_RTLDATE, SHFormatDateTime determina l'ordine di lettura dalle impostazioni locali predefinite dell'utente, inserisce i contrassegni di ordine di lettura e aggiorna il valore di output pdwFlags appropriato. Questo flag impedisce che il processo si verifichi. Viene usato più comunemente dai chiamanti legacy di SHFormatDateTime. Questo flag non può essere combinato con FDTF_RTLDATE o FDTF_LTRDATE.
Windows Server 2003 e Windows XP: Questo valore non è disponibile.
Quando la funzione termina, il valore DWORD a cui punta questo parametro può contenere zero o più flag seguenti.
FDTF_SHORTTIME (0x00000001)
0x00000001. Formatta l'ora del giorno come specificato dalla Opzioni internazionali e della lingua'applicazione nel Pannello di controllo, ma senza secondi. Questo flag non può essere combinato con FDTF_LONGTIME.
Il breve intervallo di tempo è stato formattato correttamente.
FDTF_SHORTDATE (0x00000002)
0x00000002. Formatta la data come specificato dal formato di data breve nel opzioni internazionali e linguistiche'applicazione nel Pannello di controllo. Questo flag non può essere combinato con FDTF_LONGDATE.
La data breve è stata formattata correttamente.
FDTF_LONGDATE (0x00000004)
0x00000004. Formatta la data come specificato dal formato di data estesa nel opzioni internazionali e linguistiche'applicazione nel Pannello di controllo. Questo flag non può essere combinato con FDTF_SHORTDATE.
La data estesa è stata formattata correttamente.
FDTF_LONGTIME (0x00000008)
0x00000008. Formatta l'ora del giorno come specificato dalla opzioni internazionali e linguistiche'applicazione nel Pannello di controllo, inclusi i secondi. Questo flag non può essere combinato con FDTF_SHORTTIME.
La formattazione dell'intervallo di tempo è stata completata.
FDTF_RELATIVE (0x00000010)
0x00000010. Se il flag FDTF_LONGDATE è impostato e la data nella struttura FILETIME
La notazione relativa è stata usata per la data.
[out] pszBuf
Tipo: LPTSTR
Puntatore a un buffer che riceve la data e l'ora formattate. Il buffer deve essere sufficientemente grande da contenere il numero di caratteri TCHAR specificati dal parametro cchBuf, incluso un carattere Null di terminazione.
cchBuf
Tipo: UINT
Numero di TCHAR che possono essere contenuti nel buffer a cui punta pszBuf.
Valore restituito
Tipo: int
Restituisce il numero di TCHAR scritti nel buffer, incluso il carattere Null di terminazione. In caso di errore, questo valore è 0.
Osservazioni
Nota
L'intestazione shlwapi.h definisce SHFormatDateTime come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
shlwapi.h |
| libreria |
Shlwapi.lib |
| dll | Shlwapi.dll (versione 5.0 o successiva) |