Funzione StrFromTimeIntervalW (shlwapi.h)

Articolo
11/20/2024

Converte un intervallo di tempo, specificato in millisecondi, in una stringa.

Sintassi

int StrFromTimeIntervalW(
  [out] PWSTR pszOut,
        UINT  cchMax,
        DWORD dwTimeMS,
        int   digits
);

Parametri

[out] pszOut

Tipo: PTSTR

Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve il numero convertito.

cchMax

Tipo: UINT

Dimensioni di pszOut, in caratteri. Se cchMax è impostato su zero, StrFromTimeInterval restituirà la dimensione minima del buffer di caratteri necessario per contenere la stringa convertita. In questo caso, pszOut non conterrà la stringa convertita.

dwTimeMS

Tipo: DWORD

Intervallo di tempo, espresso in millisecondi.

digits

Tipo: int

Numero massimo di cifre significative da rappresentare in pszOut. Ecco alcuni esempi:

dwTimeMS	Cifre	pszOut
34000	3	34 sec
34000	2	34 sec
34000	1	30 sec
74000	3	1 min 14 sec
74000	2	1 min 10 sec
74000	1	1 min

Valore restituito

Tipo: int

Restituisce il numero di caratteri in pszOut, escluso il carattere di terminazione NULL.

Osservazioni

Il valore di ora restituito in pszOut sarà sempre nel formato hh ore mm minuti secondi. I tempi che superano ventiquattro ore non vengono convertiti in giorni o mesi. Le frazioni di secondi vengono ignorate.

Esempi

#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"

void main(void)
{
    char TimeString[256];
    char *pszOut;
    pszOut = TimeString;

    cout << "The return value from the call to"
         << "\nthe function StrFromTimeInterval will"
         << "\nreturn the number of elements in the buffer: " << endl;

    cout << "\nThe return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 34000,30);

    cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;

    cout << "The return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 74000,3);

    cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;

    cout << "The return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 74000,2);

    cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;

    cout << "The return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 74000,1)
         << "\nThe contents of the TimeString Buffer " << pszOut << endl;
}

OUTPUT:
- - - - -
The return value from the call to
the function StrFromTimeInterval will
return the number of elements in the buffer:

The return from StrFromTimeInterval is 7
The contents of the TimeString Buffer  34 sec
The return from StrFromTimeInterval is 13
The contents of the TimeString Buffer  1 min 14 sec
The return from StrFromTimeInterval is 13
The contents of the TimeString Buffer  1 min 10 sec
The return from StrFromTimeInterval is 6
The contents of the TimeString Buffer  1 min

Nota

L'intestazione shlwapi.h definisce StrFromTimeInterval 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 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Condividi tramite