Funzione SHFormatDateTimeA (shlwapi.h)

[SHFormatDateTime è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.

Produce una rappresentazione di stringa di un'ora specificata come struttura FILETIME .

Sintassi

int SHFormatDateTimeA(
  [in]                const FILETIME *pft,
  [in, out, optional] DWORD          *pdwFlags,
  [out]               LPSTR          pszBuf,
                      UINT           cchBuf
);

Parametri

[in] pft

Tipo: const FILETIME UNALIGNED*

Puntatore alla struttura FILETIME il cui tempo deve essere convertito in una stringa.

[in, out, optional] pdwFlags

Tipo: DWORD*

Puntatore a un valore DWORD che contiene flag bit per bit che specificano il formato 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, in cui la funzione presuppone che il flag di FDTF_DEFAULT sia impostato.

FDTF_SHORTTIME (0x00000001)

0x00000001. Formatta l'ora del giorno come specificato dall'applicazione Opzioni internazionali e linguistiche in Pannello di controllo, ma senza secondi. Questo flag non può essere combinato con FDTF_LONGTIME.

Il tempo breve è stato formattato correttamente.

FDTF_SHORTDATE (0x00000002)

0x00000002. Formatta la data come specificato dal formato di data breve nell'applicazione Opzioni internazionali e linguistiche in 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 prolungata nell'applicazione Opzioni internazionali e linguistiche in Pannello di controllo. Questo flag non può essere combinato con FDTF_SHORTDATE.

La data prolungata è stata formattata correttamente.

FDTF_LONGTIME (0x00000008)

0x00000008. Formatta l'ora del giorno come specificato dall'applicazione Opzioni internazionali e linguistiche in Pannello di controllo, inclusi i secondi. Questo flag non può essere combinato con FDTF_SHORTTIME.

Il tempo è stato formattato correttamente.

FDTF_RELATIVE (0x00000010)

0x00000010. Se il flag FDTF_LONGDATE è impostato e la data nella struttura FILETIME è la stessa data in cui viene chiamato SHFormatDateTime , il giorno della settimana (se presente) viene modificato in "Today". Se la data nella struttura è il giorno precedente, il giorno della settimana (se presente) viene modificato in "Ieri".

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 segni 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 in modo appropriato. Questo flag impedisce che si verifichi tale processo. 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 restituisce, il valore DWORD a cui punta questo parametro può contenere zero o più flag seguenti.

[out] pszBuf

Tipo: LPTSTR

Puntatore a un buffer che riceve la data e l'ora formattate. Il buffer deve essere abbastanza grande per contenere il numero di caratteri TCHAR specificati dal parametro cchBuf , incluso un carattere null terminante.

cchBuf

Tipo: UINT

Numero di TCHAR che possono essere contenuti dal buffer a cui fa riferimento pszBuf.

Valore restituito

Tipo: int

Restituisce il numero di TCHAR scritti nel buffer, incluso il carattere null terminante. In caso di errore, questo valore è 0.

Commenti

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 5.0 o successiva)

Vedi anche

GetDateFormat

GetTimeFormat