Fungsi StrFromTimeIntervalA (shlwapi.h)

Artikel
08/26/2023

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

Sintaks

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 dalam pszOut, tidak termasuk karakter NULL yang mengakhiri.

Keterangan

Nilai waktu yang dikembalikan dalam pszOut akan selalu dalam bentuk hh jam mm menit ss 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

Catatan

Header shlwapi.h mendefinisikan StrFromTimeInterval sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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


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

Bagikan melalui