strftime,wcsftime,_strftime_l,_wcsftime_l

Maak een tijdtekenreeks op.

Syntaxis

size_t strftime(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr
);
size_t _strftime_l(
   char *strDest,
   size_t maxsize,
   const char *format,
   const struct tm *timeptr,
   _locale_t locale
);
size_t wcsftime(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr
);
size_t _wcsftime_l(
   wchar_t *strDest,
   size_t maxsize,
   const wchar_t *format,
   const struct tm *timeptr,
   _locale_t locale
);

Parameterwaarden

strDest
Uitvoertekenreeks.

maxsize
Grootte van de strDest buffer, gemeten in tekens (char of wchar_t).

format
Tekenreeks voor besturingselement opmaken.

timeptr
tm datastructuur.

locale
De landinstelling die moet worden gebruikt.

Retourwaarde

strftime retourneert het aantal tekens dat is strDest geplaatst en wcsftime retourneert het bijbehorende aantal brede tekens.

Als het totale aantal tekens, inclusief de nul-eindwaarde, groter is dan maxsize, strftime en wcsftime 0 als resultaat geeft en de inhoud strDest ervan onbepaald is.

Het aantal tekens in strDest is gelijk aan het aantal letterlijke tekens in format, plus alle tekens waaraan kan worden toegevoegd format via opmaakcodes. De afsluit-null van een tekenreeks wordt niet meegeteld in de retourwaarde.

Opmerkingen

Met strftime de functies wcsftime wordt de tm tijdwaarde opgemaakt timeptr op basis van het opgegeven format argument en wordt het resultaat opgeslagen in de buffer strDest. Maximaal maxsize worden tekens in de tekenreeks geplaatst. Zie voor een beschrijving van de velden in de timeptr structuur asctime. wcsftime is het wide-character equivalent van strftime; het argument tekenreeks-aanwijzer verwijst naar een tekenreeks met een breed teken. Deze functies gedragen zich op dezelfde manier als anders.

Met deze functie worden de parameters gevalideerd. AlsstrDest, formatof timeptr een null-aanwijzer is, of als de gegevensstructuur die is geadresseerdtimeptr, ongeldig is (bijvoorbeeld als deze tm waarden buiten het bereik voor de tijd of datum bevat), of als de format tekenreeks een ongeldige opmaakcode bevat, wordt de ongeldige parameterhandler aangeroepen, zoals beschreven in parametervalidatie. Als de uitvoering mag worden voortgezet, retourneert de functie 0 en wordt ingesteld errno op EINVAL.

De globale status van deze functie is standaard gericht op de toepassing. Als u dit gedrag wilt wijzigen, raadpleegt u de globale status in de CRT.

Algemene routinetoewijzingen voor tekst

Het format argument bestaat uit een of meer codes, zoals in printf, de opmaakcodes worden voorafgegaan door een procentteken (%). Tekens die niet beginnen, % worden ongewijzigd gekopieerd naar strDest. De LC_TIME categorie van de huidige landinstelling is van invloed op de uitvoeropmaak van strftime. Zie voor meer informatie over LC_TIMEsetlocale. De strftime en wcsftime functies gebruiken de landinstelling die momenteel is ingesteld. De _strftime_l en _wcsftime_l versies van deze functies zijn identiek, behalve dat ze de landinstelling als parameter gebruiken en die gebruiken in plaats van de landinstelling die momenteel is ingesteld. Zie landinstellingenvoor meer informatie.

De strftime functies ondersteunen deze opmaakcodes:

Net als in de printf functie kan de # vlag alle opmaakcode vooraf laten gaan. In dat geval wordt de betekenis van de notatiecode als volgt gewijzigd.

Het ISO 8601 week- en weekjaar geproduceerd door %V, %gen %Ggebruikt een week die op maandag begint. Week 1 is de week die de vierde dag van januari bevat, de eerste week met ten minste vier dagen van het jaar. Als de eerste maandag van het jaar de 2e, 3e of 4e is, maken de voorgaande dagen deel uit van de vorige week van het voorgaande jaar. Voor die dagen %V wordt deze vervangen door 53, en beide %g en %G worden vervangen door de cijfers van het voorgaande jaar.

Behoeften

De _strftime_l functies en _wcsftime_l functies zijn specifiek voor Microsoft. Zie Compatibiliteit voor meer compatibiliteitsinformatie.

Voorbeeld

Zie het voorbeeld voor time.

Zie ook

Lokale instellingen
Tijdbeheer
tekenreeksbewerking
localeconv
setlocale, _wsetlocale
strcoll functies
strxfrm, , , wcsxfrm_strxfrm_l_wcsxfrm_l