ctime, _ctime32_ctime64, _wctime, _wctime32_wctime64

Converteer een tijdwaarde naar een tekenreeks en pas deze aan voor lokale tijdzone-instellingen. Er zijn veiligere versies van deze functies beschikbaar; zie ctime_s, _ctime32_s, _ctime64_s, , _wctime_s, , _wctime32_s. _wctime64_s

Syntaxis

char *ctime( const time_t *sourceTime ); // See note in remarks section about linkage
char *_ctime32( const __time32_t *sourceTime );
char *_ctime64( const __time64_t *sourceTime );
wchar_t *_wctime( const time_t *sourceTime ); // See note in remarks section about linkage
wchar_t *_wctime32( const __time32_t *sourceTime );
wchar_t *_wctime64( const __time64_t *sourceTime );

Parameterwaarden

sourceTime
Aanwijzer naar opgeslagen tijd om te converteren.

Retourwaarde

Een aanwijzer naar het tekenreeksresultaat. NULL wordt geretourneerd wanneer:

• sourceTime vertegenwoordigt een datum vóór middernacht, 1 januari 1970, UTC.

• U gebruikt _ctime32 of _wctime32, en sourceTime vertegenwoordigt een datum na 23:59:59 januari 18 januari 2038, UTC.

• U gebruikt _ctime64 of _wctime64, en sourceTime vertegenwoordigt een datum na 23:59:59, 31 december 3000, UTC.

ctime is een inline-functie die resulteert _ctime64in , en time_t gelijk is aan __time64_t. Als u wilt afdwingen dat de compiler wordt geïnterpreteerd time_t als de oude 32-bits time_t, kunt u definiëren _USE_32BIT_TIME_T. Deze macro zorgt ervoor ctime dat deze wordt geëvalueerd _ctime32. We raden u niet aan deze te gebruiken, omdat uw toepassing na 18 januari 2038 kan mislukken en dit niet is toegestaan op 64-bits platforms.

Opmerkingen

De ctime functie converteert een tijdwaarde die is opgeslagen als een time_t waarde in een tekenreeks. De sourceTime waarde wordt meestal verkregen van een aanroep naar time, waarmee het aantal seconden wordt geretourneerd dat is verstreken sinds middernacht (00:00:00), 1 januari 1970, gecoördineerde universele tijd (UTC). De tekenreeks voor de retourwaarde bevat precies 26 tekens en heeft het formulier:

Wed Jan 02 02:03:55 1980\n\0

Er wordt een 24-uursklok gebruikt. Alle velden hebben een constante breedte. Het nieuwe regelteken ('\n') en het null-teken ('\0') bezetten de laatste twee posities van de tekenreeks.

De geconverteerde tekenreeks wordt ook aangepast op basis van de lokale tijdzone-instellingen. Zie de functies en _ftimelocaltime functies voor meer informatie over het configureren van de timelokale tijd. Zie de _tzset functie voor meer informatie over het definiëren van de tijdzoneomgeving en globale variabelen.

Een aanroep voor ctime het wijzigen van de enkele statisch toegewezen buffer die door de gmtime en localtime functies wordt gebruikt. Elke aanroep van een van deze routines vernietigt het resultaat van de vorige aanroep. ctime deelt een statische buffer met de asctime functie. Een oproep om ctime de resultaten van een eerdere aanroep naar asctime, localtimeof gmtime.

_wctime en _wctime64 zijn de brede tekenversie van ctime en _ctime64; die een aanwijzer retourneert naar tekenreeks met brede tekens. Anders, _ctime64, _wctimeen _wctime64 gedragen zich identiek aan ctime.

Deze functies valideren hun parameters. Als sourceTime dit een null-aanwijzer is of als de sourceTime waarde negatief is, roepen deze functies de ongeldige parameterhandler aan, zoals beschreven in parametervalidatie. Als de uitvoering mag worden voortgezet, worden de functies geretourneerd NULL en ingesteld op errnoEINVAL.

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

Requirements

Zie Compatibiliteit voor meer compatibiliteitsinformatie.

Example

// crt_ctime64.c
// compile with: /W3
/* This program gets the current
* time in _time64_t form, then uses ctime to
* display the time in string form.
*/

#include <time.h>
#include <stdio.h>

int main( void )
{
   __time64_t ltime;

   _time64( &ltime );
   printf( "The time is %s\n", _ctime64( &ltime ) ); // C4996
   // Note: _ctime64 is deprecated; consider using _ctime64_s
}

The time is Wed Feb 13 16:04:43 2002

Zie ook

Tijdbeheer
asctime, _wasctime
ctime_s, , _ctime32_s_ctime64_s, _wctime_s, , , _wctime32_s_wctime64_s
_ftime, _ftime32_ftime64
gmtime, _gmtime32_gmtime64
localtime, _localtime32_localtime64
time, _time32_time64