Funzione GetDateFormatWrapW

[GetDateFormatWrapW è disponibile per l'uso in Windows XP. Non sarà disponibile nelle versioni successive. È consigliabile usare GetDateFormatW nel suo posto.

Formatta una data come stringa di data per le impostazioni locali specificate. La funzione formatta una data specificata o la data di sistema locale.

Nota

GetDateFormatWrapW è un wrapper per la funzione GetDateFormatW . Per ulteriori note sull'utilizzo, vedere la pagina GetDateFormat .

 

Sintassi

int GetDateFormatWrapW(
  _In_        LCID       Locale,
  _In_        DWORD      dwFlags,
  _In_  const SYSTEMTIME *lpDate,
  _In_        LPCWSTR    pwzFormat,
  _Out_       LPWSTR     pwzDateStr,
  _In_        int        cchDate
);

Parametri

Impostazioni locali [in]

Tipo: LCID

Impostazioni locali per cui deve essere formattata la stringa di data. Se pwzFormat è NULL, la funzione formatta la stringa in base al formato data per le impostazioni locali. Se pwzFormat non è NULL, la funzione usa solo le impostazioni locali per informazioni non specificate nella stringa di immagine in formato (ad esempio, i nomi dei giorni e dei mesi delle impostazioni locali).

Questo parametro può essere un identificatore delle impostazioni locali creato dalla macro MAKELCID o uno dei valori predefiniti seguenti.

LOCALE_SYSTEM_DEFAULT

Impostazioni locali di sistema predefinite.

LOCALE_USER_DEFAULT

Impostazioni locali utente predefinite.

dwFlags [in]

Tipo: DWORD

Specifica varie opzioni di funzione. Se pwzFormat non è NULL, questo parametro deve essere zero. Se pwzFormat è NULL, è possibile specificare una combinazione dei valori seguenti. Se non si specificano DATE_YEARMONTH, DATE_SHORTDATE o DATE_LONGDATE e pwzFormat è NULL, DATE_SHORTDATE viene usato come impostazione predefinita.

LOCALE_NOUSEROVERRIDE

Se impostato, la funzione formatta la stringa usando il formato di data predefinita del sistema per le impostazioni locali specificate. Se non è impostato, la funzione formatta la stringa usando qualsiasi override utente nel formato di data predefinito delle impostazioni locali.

LOCALE_USE_CP_ACP

Usa la tabella codici ANSI di sistema per la traduzione di stringhe anziché la tabella codici delle impostazioni locali.

DATE_SHORTDATE

Usa il formato di data breve. Questo valore non può essere usato con DATE_LONGDATE o DATE_YEARMONTH.

DATE_LONGDATE

Usa il formato di data prolungata. Questo valore non può essere usato con DATE_SHORTDATE o DATE_YEARMONTH.

DATE_YEARMONTH

Usa il formato anno/mese. Questo valore non può essere usato con DATE_SHORTDATE o DATE_LONGDATE.

DATE_USE_ALT_CALENDAR

Usa il calendario alternativo, se presente, per formattare la stringa di data. Se questo flag è impostato, la funzione usa il formato predefinito per tale calendario alternativo, anziché usare eventuali overridi utente. Gli overridi utente verranno usati solo nel caso in cui non sia presente alcun formato predefinito per il calendario alternativo specificato.

DATE_LTRREADING

Aggiunge segni per il layout di lettura da sinistra a destra. Questo valore non può essere usato con DATE_RTLREADING.

DATE_RTLREADING

Aggiunge segni per il layout di lettura da destra a sinistra. Questo valore non può essere usato con DATE_LTRREADING.

lpDate [in]

Tipo: const SYSTEMTIME*

Puntatore a una struttura SYSTEMTIME contenente le informazioni sulla data da formattare. Se questo puntatore è NULL, la funzione usa la data di sistema locale corrente.

pwzFormat [in]

Tipo: LPCWSTR

Puntatore a un'immagine di formato da usare per formare la stringa di data. Se pwzFormat è NULL, la funzione usa il formato data delle impostazioni locali specificate. Per altre informazioni, vedere GetDateFormat .

pwzDateStr [out]

Tipo: LPWSTR

Puntatore a un buffer che riceve la stringa di data formattata.

cchDate [in]

Tipo: int

Specifica le dimensioni, in caratteri, del buffer pwzDateStr . Se cchDate è zero, la funzione restituisce il numero di caratteri necessari per contenere la stringa di data formattata e il buffer a cui punta pwzDateStr non viene usato.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è il numero di caratteri scritti nel buffer a cui fa riferimento pwzDateStr. Se il parametro cchDate è zero, il valore restituito è il numero di caratteri necessari per contenere la stringa di data formattata. Il conteggio include il carattere Null terminante.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire uno dei codici di errore seguenti.

ERROR_INSUFFICIENT_BUFFER

ERROR_INVALID_FLAGS

ERROR_INVALID_PARAMETER

Commenti

GetDateFormatWrapW offre la possibilità di usare stringhe Unicode nei sistemi operativi precedenti a Windows XP. Il metodo preferito consiste nell'usare GetDateFormatW in combinazione con Microsoft Layer for Unicode (MSLU).

GetDateFormatWrapW deve essere chiamato direttamente dalla Shlwapi.dll, usando ordinal 311.

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
DLL
Shlwapi.dll (versione 5.0 o successiva)

Vedi anche

GetDateFormat

 

 

  • Last updated on