C date and time functions

C standard library (libc)
General topics
Miscellaneous headers

The C date and time functions are a group of functions in the standard library of the C programming language implementing date and time manipulation operations.[1] They provide support for time acquisition, conversion between date formats, and formatted output to strings.

History

The format string used in strftime traces back to at least PWB/UNIX 1.0, released in 1977. Its date system command includes various formatting options.[2][3] In 1989, the ANSI C standard is released including strftime and other date and time functions.[4]

Overview of functions

The C date and time operations are defined in the time.h header file (ctime header in C++).

Identifier Description
Time
manipulation 		difftime computes the difference in seconds between two time_t values
time returns the current time of the system as a time_t value, number of seconds, (which is usually time since an epoch, typically the Unix epoch). The value of the epoch is operating system dependent; 1900 and 1970 are often used. See RFC 868.
clock returns a processor tick count associated with the process
timespec_get (C11) returns a calendar time based on a time base
Format
conversions 		asctime converts a struct tm object to a textual representation (deprecated)
ctime converts a time_t value to a textual representation
strftime converts a struct tm object to custom textual representation
strptime converts a string with time information to a struct tm
wcsftime converts a struct tm object to custom wide string textual representation
gmtime converts a time_t value to calendar time expressed as Coordinated Universal Time[5]
localtime converts a time_t value to calendar time expressed as local time
mktime converts calendar time to a time_t value.
Constants CLOCKS_PER_SEC number of processor clock ticks per second
TIME_UTC time base for UTC
Types struct tm broken-down calendar time type: year, month, day, hour, minute, second
time_t arithmetic time type (typically time since the Unix epoch)
clock_t process running time type
timespec time with seconds and nanoseconds

The timespec and related types were originally proposed by Markus Kuhn to provide a variety of time bases, but only TIME_UTC was accepted.[6] The functionalities were, however, added to C++ in 2020 in std::chrono.

Example

The following C source code prints the current time to the standard output stream. 

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

int main(void)
{
    time_t current_time;
    char* c_time_string;

    /* Obtain current time. */
    current_time = time(NULL);

    if (current_time == ((time_t)-1))
    {
        (void) fprintf(stderr, "Failure to obtain the current time.\n");
        exit(EXIT_FAILURE);
    }

    /* Convert to local time format. */
    c_time_string = ctime(&current_time);

    if (c_time_string == NULL)
    {
        (void) fprintf(stderr, "Failure to convert the current time.\n");
        exit(EXIT_FAILURE);
    }

    /* Print to stdout. ctime() has already added a terminating newline character. */
    (void) printf("Current time is %s", c_time_string);
    exit(EXIT_SUCCESS);
}

The output is: 

Current time is Thu Sep 15 21:18:23 2016

See also

References

  1. ^ ISO/IEC 9899:1999 specification (PDF). p. 351, § 7.32.2.
  2. ^ "PWB1 date system command - man page". www.tuhs.org.
  3. ^ "date.c sourcecode of PWB1". www.tuhs.org.
  4. ^ "Rationale for American National Standard for Information Systems - Programming Language - C - Date and Time". www.lysator.liu.se.
  5. ^ open-std.org - Committee Draft -- May 6, 2005 page 355
  6. ^ Markus Kuhn. "Modernized API for ISO C". cl.cam.ac.uk.
The Wikibook C Programming has a page on the topic of: C Programming/C Reference

Read other articles:

Gladys Brockwell

Gladys BrockwellBrockwell, c. 1920LahirGladys LindemanSeptember 26, 1894Brooklyn, New York, A.S.Meninggal2 Juli 1929(1929-07-02) (umur 0)Hollywood, California, A.S.PekerjaanAktrisTahun aktif1913–1929Suami/istriRobert B. Broadwell ​ ​(m. 1915; c. 1918)​ Harry Edwards ​ ​(m. 1918; annulled 1919)​ Gladys Brockwell (née Lindeman; 26 September 1894 – 2 Juli 1929)[1]...

 

 

Kissamos

Municipality in GreeceKissamos ΚίσσαμοςMunicipalityKissamosKissamosLocation within the region Coordinates: 35°29′N 23°39′E / 35.483°N 23.650°E / 35.483; 23.650CountryGreeceAdministrative regionCreteRegional unitChaniaGovernment • MayorTheodoros StathatkisArea • Municipality341.0 km2 (131.7 sq mi) • Municipal unit149.0 km2 (57.5 sq mi)Population (2011)[1] • Municip...

 

 

شعار الجزائر

شعار الجزائر   التفاصيل المستعمل الجمهورية الجزائرية الديموقراطية الشعبية البلد الجزائر  الاعتماد 1 نوفمبر 1976 (منذ 47 سنة) الدرع علم الجزائر مجالات الاستخدام يوضع على العمله الوطنية و المباني الحكومية (البرلمان و القصر الرئاسي و المحكمة العليه) و علي بطاقات الهويه و ج�...

Opole Voivodeship

Voivodeship of Poland Voivodeship in PolandOpole Voivodeship Województwo opolskieVoivodeship FlagCoat of armsBrandmarkLocation within PolandAdministrative divisionsCoordinates (Opole): 50°40′N 17°56′E / 50.667°N 17.933°E / 50.667; 17.933Country PolandCapitalOpoleCounties 1 city, 11 land counties,further divided into 71 gminas OpoleBrzeg CountyGłubczyce CountyKędzierzyn-Koźle CountyKluczbork CountyKrapkowice CountyNamysłów CountyNysa CountyOlesno ...

 

 

Gunung Sorik Marapi

Gunung SorikmarapiMount SorikmarapiTitik tertinggiKetinggian2,145 m (7,04 ft)[1]Koordinat0°41′10″N 99°32′20″E / 0.686°N 99.539°E / 0.686; 99.539 GeografiGunung SorikmarapiMandailing Natal, Sumatera Utara, IndonesiaPegununganBukit BarisanGeologiJenis gunungstratovolcanoBusur/sabuk vulkanikBusur Sunda / Sabuk alpidaLetusan terakhirJuli 1986 Sorik Marapi adalah sebuah gunung yang masuk dalam kawasan Taman Nasional Batang Gadis, secara a...

 

 

Camelsfoot Range

Sub-range of the Chilcotin Ranges in British Columbia, Canada Camelsfoot RangeSouthern ridges in the Camelsfoot Range near the Fraser RiverHighest pointPeakRed MountainElevation2,445 m (8,022 ft)Coordinates51°12′13.0″N 122°32′55.0″W / 51.203611°N 122.548611°W / 51.203611; -122.548611DimensionsArea2,390 km2 (920 sq mi)GeographyLocation map of Camelsfoot Range CountryCanadaProvinceBritish ColumbiaParent rangeChilcotin Ranges and ...

1946 Boston Red Sox season

Major League Baseball season Major League Baseball team season 1946 Boston Red SoxAmerican League ChampionsLeagueAmerican LeagueBallparkFenway ParkCityBoston, MassachusettsRecord104–50 (.675)League place1stOwnersTom YawkeyPresidentTom YawkeyGeneral managersEddie CollinsManagersJoe CroninRadioWNAC(Jim Britt, Tom Hussey)StatsESPN.comBB-reference ← 1945 Seasons 1947 → The 1946 Boston Red Sox season was the 46th season in the franchise's Major League Baseball history....

 

 

Just Listen (album mini)

Just ListenAlbum mini karya YounhaDirilis2 Mei 2013Direkam2013GenreRock, pop rockBahasaKoreaLabelWealive/CJ E&M MusicKronologi Younha Supersonic(2012)Supersonic2012 Just Listen(2013) Subsonic(2013)Subsonic2013 Just Listen adalah album mini kedua dari penyanyi asal Korea Selatan Younha.[1] Daftar lagu Daftar lagu dan kredit yang terungkap secara daring pada hari rilis .[2] No.JudulLirikMusikDurasi1.Just Listen (featuring Skull)Younha, SkullScore, Skull3:402.FireworksYou...

 

 

MLK/FBI

2020 American filmMLK/FBIFilm posterDirected bySam PollardWritten by Benjamin Hedin Laura Tomaselli Produced byBenjamin HedinCinematographyRobert ChappellEdited byLaura TomaselliMusic byGerald ClaytonProductioncompanies Field of Vision Tradecraft Films Play/Action Pictures Distributed byIFC FilmsRelease dates September 15, 2020 (2020-09-15) (TIFF) January 15, 2021 (2021-01-15) (United States) Running time104 minutes[1]CountryUnited StatesLanguageE...

Metode penghabis

Dalam matematika, metode penghabis[1][2] (Latin: methodus exhaustionibus) adalah suatu cara kuno untung menghitung luas, volume, dan panjang dari bentuk geometri melengkung, seperti lingkaran. Gagasan tentang metode ini mulanya dicetuskan oleh Antifon, namun pengembangan dan penerapannya dilakukan oleh Eudoksos dari Knidos Istilah metode penghabis mula digunakan oleh Grégoire de Saint-Vincent di tahun 1647, yang mana sebelumnya metode ini tidak dinamai khusus. Metode penghabi...

 

 

Paul Gorguloff

Paul GorguloffGorguloff (berdiri) saat pengadilanLahirPavel Timofeyevich Gorgulov29 Juni 1895Labinsk, Oblast Kuban, Kekaisaran RusiaMeninggal14 September 1932 (usia 37)Paris, PrancisSebab meninggalEksekusiHukuman kriminalHukuman mati dengan cara dipancungStatus kriminalAlmarhumMotifPolitikAlasanPembunuhan Paul Gorguloff, dulunya Pavel Timofeyevich Gorgulov (bahasa Rusia: Павел Тимофеевич Горгулов; 29 Juni 1895 – 14 September 1932) adalah seoran...

 

 

Welsh gold

Gold mined in 2 distinct areas of Wales The Mold Cape, solid sheet-gold, c. 1900–1600 BC, Bronze Age. It was found at Mold in Flintshire, Wales, in 1833 The Bronze Age Burton Hoard, from Burton, Wrexham. The gold items are a folded torc, a twisted-wire bracelet, a necklace pendant, 4 beads and 3 rings (National Museum Wales). Welsh gold is gold found in natural geological deposits in two distinct areas of Wales and highly prized [by whom?] because of its origin and scarcity[cita...

Irish people in Japan

Irish expatriates in Japan Ethnic group Irish people in JapanTotal population1,247 (in December, 2022)[1][2]Regions with significant populationsTokyo · OsakaLanguagesEnglish · Irish · JapaneseRelated ethnic groupsIrish diaspora The community of Irish people in Japan is estimated to constitute 1,000–2,000 people.[3][4] Notable people Lafcadio HearnFrancis Brinkley Shane Berkery Matt Heafy Francis Brinkley Eileen Lynn K...

 

 

Gold certificate (United States)

Certificate of ownership that gold owners held instead of storing the actual gold This article is missing information about 1953-53 monetization mentioned at 2011 United States debt-ceiling crisis#Monetizing gold. Please expand the article to include this information. Further details may exist on the talk page. (May 2023) A Series 1934 $10,000 gold certificate depicting Salmon P. Chase, Smithsonian Institution Gold certificates were issued by the United States Treasury as a form of representa...

 

 

George Ball (diplomat)

United States diplomat that spoke out against U.S. involvement in Vietnam George W. Ball redirects here. For other people with similar names, see George Ball (disambiguation). George BallBall in 19667th United States Ambassador to the United NationsIn officeJune 26, 1968 – September 25, 1968PresidentLyndon B. JohnsonPreceded byArthur GoldbergSucceeded byJames R. Wiggins23rd United States Under Secretary of StateIn officeDecember 4, 1961 – September 30, 1966PresidentJohn ...

Fucales

Fucales Ascophyllum nodosum Klasifikasi ilmiah Domain: Eukaryota Kerajaan: Chromalveolata Filum: Heterokontophyta Kelas: Phaeophyceae Ordo: FucalesKylin Famili Bifurcariopsidaceae Cystoseiraceae Durvillaeaceae Fucaceae Himanthaliaceae Hormosiraceae Notheiaceae Sargassaceae Seirococcaceae Xiphophoraceae Fucales adalah ordo dalam filum Phaeophyta atau ganggang coklat. Anggota ordo ini adalah Fucoid. Referensi Fletcher, R.L.1987. Seaweeds of the British Isles. Volume 3, Part 1. British Museum (...

 

 

Riverfront

Region along a river This article does not cite any sources. Please help improve this article by adding citations to reliable sources. Unsourced material may be challenged and removed.Find sources: Riverfront – news · newspapers · books · scholar · JSTOR (February 2022) (Learn how and when to remove this message) A riverfront is a region along a river. Often in larger cities that are traversed or bordered by one or more rivers. The riverfronts are most...

 

 

甲斐國

此條目没有列出任何参考或来源。 (2019年3月14日)維基百科所有的內容都應該可供查證。请协助補充可靠来源以改善这篇条目。无法查证的內容可能會因為異議提出而被移除。 日語寫法日語原文甲斐国假名かいのくに平文式罗马字Kai no kuni 甲斐國（日语：甲斐国〔甲斐國〕／かいのくに〔かひのくに〕 Kainokuni */?），是日本古代的令制國之一，屬東海道，亦稱為甲州（...

Eyalet di Diyarbekir

Eyalet di DiyarbekirEyalet di Diyarbekir - LocalizzazioneL'eyalet di Diyarbekir nel 1609 Dati amministrativiNome completoEyalet-i Diyâr-ı Bekr Lingue ufficialiturco ottomano Lingue parlateturco ottomano, arabo CapitaleAmid (attuale Diyarbakır) Dipendente daImpero ottomano PoliticaForma di StatoEyalet Forma di governoEyalet elettivo dell'Impero ottomano Capo di StatoSultani ottomani Nascita1515 Fine1867 Territorio e popolazioneBacino geograficoMesopotamia Massima estensione52,660 km2 nel XI...

 

 

Copa Libertadores 2010

Copa Libertadores 2010 Généralités Sport Football Organisateur(s) CONMEBOL Éditions 51e Date du 26 janvier au 30 juin 2010 Nations 11 Participants 40 Palmarès Tenant du titre Estudiantes de La Plata Vainqueur Sport Club Internacional Finaliste Chivas de Guadalajara Meilleur(s) buteur(s) Thiago Ribeiro (8) Navigation Édition précédente Édition suivante modifier La Copa Libertadores 2010 est la 51e édition de la Copa Libertadores. Le club vainqueur de la compétition est désign...