Fungsi StrFromTimeIntervalA (shlwapi.h)

Mengonversi interval waktu, yang ditentukan dalam milidetik, menjadi string.

Sintaksis

int StrFromTimeIntervalA(
  [out] PSTR  pszOut,
        UINT  cchMax,
        DWORD dwTimeMS,
        int   digits
);

Parameter

[out] pszOut

Jenis: PTSTR

Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima angka yang dikonversi.

cchMax

Jenis: UINT

Ukuran pszOut, dalam karakter. Jika cchMax diatur ke nol, StrFromTimeInterval akan mengembalikan ukuran minimum buffer karakter yang diperlukan untuk menahan string yang dikonversi. Dalam hal ini, pszOut tidak akan berisi string yang dikonversi.

dwTimeMS

Jenis: DWORD

Interval waktu, dalam milidetik.

digits

Jenis: int

Jumlah maksimum digit signifikan yang akan diwakili dalam pszOut. Beberapa contohnya adalah:

dwTimeMS	Digit	pszOut
34000	3	34 detik
34000	2	34 detik
34000	1	30 detik
74000	3	1 menit 14 detik
74000	2	1 menit 10 detik
74000	1	1 menit

Mengembalikan nilai

Jenis: int

Mengembalikan jumlah karakter dalampszOut , tidak termasuk karakter NULL yang dihentikan.

Komentar

Nilai waktu yang dikembalikan dalam pszOut akan selalu dalam bentuk jam mm menit detik. Waktu yang melebihi dua puluh empat jam tidak dikonversi menjadi hari atau bulan. Pecahan detik diabaikan.

Contoh

#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

Header shlwapi.h mendefinisikan StrFromTimeInterval sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 4.71 atau yang lebih baru)