La fonction wcsftime () en C ++ convertit la date et l'heure données à partir d'une heure de calendrier donnée en une chaîne de caractères large terminée par null selon une chaîne de format.
La fonction wcsftime () est définie dans le fichier d'en-tête.
prototype wcsftime ()
size_t wcsftime (wchar_t * str, size_t count, const wchar_t * format, const tm * time);
La fonction wcsftime () prend 4 arguments: str, count, format et time.
Les informations de date et d'heure pointées par time sont converties en un caractère large terminé par null en fonction de la valeur de format et sont stockées dans le tableau large pointé par str. Au plus count octets sont écrits.
Paramètres wcsftime ()
- str: pointeur vers le premier élément du tableau de caractères large pour stocker le résultat.
- count: nombre maximum de caractères larges à écrire.
- format: pointeur vers une chaîne de caractères large terminée par un zéro spécifiant le format de conversion. La chaîne de format se compose d'un spécificateur de conversion (commençant par% et éventuellement suivi par E ou O) et d'autres caractères larges ordinaires.
Les caractères larges ordinaires, y compris le caractère large nul de fin, sont copiés tels quels dans la chaîne large de sortie. Spécificateurs de format pour wcsftime ()Spécificateur de conversion La description Champs utilisés % Écrit le caractère% n Écrit le caractère de nouvelle ligne t Écrit le caractère de tabulation horizontale An Oui Écrit 4 chiffres de l'année, par exemple 2011 tm_year EY Écrit 4 chiffres de l'année dans la représentation alternative de la locale tm_year y Écrit les 2 derniers chiffres de l'année, plage (00, 99) tm_year Oy Écrit les 2 derniers chiffres de l'année dans la représentation alternative de la locale tm_year Ey Écrit l'année en tant que décalage par rapport à la période calendaire alternative des paramètres régionaux% EC (dépendant des paramètres régionaux) tm_year C Écrit les 2 premiers chiffres de l'année, plage (00,99) tm_year CE Écrit le nom de l'année de base (période) dans la représentation alternative de la locale, tm_year g Écrit l'année basée sur la semaine ISO 8601, c'est-à-dire l'année qui contient la semaine spécifiée. tm_year, tm_wday, tm_yday g Écrit les 2 derniers chiffres de l'année basée sur la semaine ISO 8601, c'est-à-dire l'année qui contient la semaine spécifiée (plage (00,99)). tm_year, tm_wday, tm_yday Mois b Écrit le nom du mois abrégé, par exemple Jan tm_mon h Identique à b tm_mon B Écrit le nom complet du mois, par exemple janvier tm_mon m Écrit le mois sous forme de nombre décimal, plage (01,12) tm_mon Om Écrit le mois en utilisant le système numérique alternatif de la locale tm_mon La semaine U Écrit la semaine de l'année sous forme de nombre décimal de 00 à 53 (le dimanche est le premier jour de la semaine) tm_year, tm_wday, tm_yday OU Écrit la semaine de l'année en% U en utilisant le système numérique alternatif tm_year, tm_wday, tm_yday W Écrit la semaine de l'année sous forme de nombre décimal de 00 à 53 (le lundi est le premier jour de la semaine) tm_year, tm_wday, tm_yday OW Écrit la semaine de l'année en% W en utilisant le système numérique alternatif tm_year, tm_wday, tm_yday V Écrit la semaine ISO 8601 de l'année (plage (01,53)). tm_year, tm_wday, tm_yday VO Écrit la semaine de l'année, comme par% V, en utilisant le système numérique alternatif tm_year, tm_wday, tm_yday Jour de l'année / mois j Écrit le jour de l'année sous forme de nombre décimal, plage (001366) tm_yday ré Écrit le jour du mois sous forme de nombre décimal, plage (01,31) tm_mday Od Écrit le jour du mois, comme par% d, en utilisant le système numérique alternatif tm_mday e Écrit le jour du mois sous forme de nombre décimal, plage (1,31) tm_mday Oe Écrit le jour du mois, comme par% e, en utilisant le système numérique alternatif tm_mday Jour de la semaine une Écrit le nom abrégé du jour de la semaine, par exemple Ven (dépendant de la langue) tm_wday UNE Écrit le nom complet du jour de la semaine, par exemple vendredi (selon les paramètres régionaux) tm_wday w Écrit le jour de la semaine sous forme de nombre décimal, plage (0-6) (dimanche est 0) tm_wday Ow Écrit le jour de la semaine comme par% w, en utilisant le système numérique alternatif tm_wday u Écrit le jour de la semaine sous forme de nombre décimal, où lundi vaut 1 (format ISO 8601), plage (1-7) tm_wday Ou Écrit le jour de la semaine comme par% u, en utilisant le système numérique alternatif tm_wday Heure, minute, seconde H Écrit l'heure sous forme de nombre décimal, plage (00,23) tm_hour OH Écrit l'heure comme par% H, en utilisant le système numérique alternatif tm_hour je Écrit l'heure sous forme de nombre décimal, plage (01,12) tm_hour OI Écrit l'heure comme par% I, en utilisant le système numérique alternatif tm_hour M Écrit les minutes sous forme de nombre décimal, plage (00,59) tm_min OM Écrit la minute comme par% M, en utilisant le système numérique alternatif tm_min S Écrit la seconde sous forme de nombre décimal, plage (00,60) tm_sec OS Écrit la seconde par% S, en utilisant le système numérique alternatif tm_sec Autre c Écrit une chaîne de date et d'heure standard, par exemple, dimanche 17 octobre 04:41:13 2010 (en fonction des paramètres régionaux) tout Ec Écrit la chaîne alternative de date et d'heure des paramètres régionaux tout X Écrit une représentation de date localisée (dépendante des paramètres régionaux) tout Ex Écrit la représentation alternative de la date de la locale tout X Écrit une représentation temporelle localisée (dépendante des paramètres régionaux) tout EX Écrit la représentation temporelle alternative de la locale tout ré Équivalent à «% m /% d /% y» tm_mon, tm_mday, tm_year F Équivalent à «% Y-% m-% d» tm_mon, tm_mday, tm_year r Écrit l'heure locale de 12 heures tm_hour, tm_min, tm_sec R Équivalent à «% H:% M» tm_hour, tm_min T Équivalent à "% H:% M:% S tm_hour, tm_min, tm_sec P Écrit le matin ou l'après-midi localisé (en fonction des paramètres régionaux) tm_hour z écrit le décalage par rapport à UTC au format ISO 8601 (par exemple -0545), ou aucun caractère si les informations de fuseau horaire ne sont pas disponibles tm_isdst Z Écrit le nom ou l'abréviation du fuseau horaire, ou rien si les informations de fuseau horaire ne sont pas disponibles (en fonction des paramètres régionaux) tm_isdst - time: les informations de date et d'heure à convertir.
wcsftime () Valeur de retour
- En cas de succès, la fonction wcsftime () renvoie le nombre de caractères larges écrits dans le tableau de caractères larges pointé par str sans inclure le L ' 0' de fin.
- Si le nombre a été atteint avant que la chaîne entière puisse être stockée, 0 est renvoyé et le contenu n'est pas défini.
Exemple: Comment fonctionne la fonction wcsftime ()?
#include #include #include using namespace std; int main() ( time_t curr_time; tm * curr_tm; wchar_t date_string(100); wchar_t time_string(100); time(&curr_time); curr_tm = localtime(&curr_time); wcsftime(date_string, 50, L"Today is %B %d, %Y", curr_tm); wcsftime(time_string, 50, L"Current time is %T", curr_tm); wcout << date_string << endl; wcout << time_string << endl; return 0; )
Lorsque vous exécutez le programme, la sortie sera:
Aujourd'hui 21 avril 2017 Heure actuelle est 14:42:45