tijd – Time toegang en conversies¶

Functies¶

time.asctime()¶

Converteren van een tupel, of struct_time vertegenwoordigt een tijd zoals geretourneerd doorgmtime() of localtime() string van de followingform: 'Sun Jun 20 23:21:05 1993'. Het veld dag bestaat uit twee tekens en is opgevuld als de dag een enkel cijfer is, bijvoorbeeld: 'Wed Jun 9 04:26:40 1993'.,

Als t niet is opgegeven, wordt de huidige tijd gebruikt zoals aangegeven door localtime(). Lokale informatie wordt niet gebruikt door asctime().

time.pthread_getcpuclockid(thread_id)¶

Return the clk_id of the thread-specific CPU-time clock for the specified thread_id.,

gebruik threading.get_ident() of het identattribuut van threading.Thread objecten om een geschikte waarde voor thread_id te krijgen.

beschikbaarheid: Unix (zie de manpage voor pthread_getcpuclockid (3) voor meer informatie).

time.clock_getres(clk_id)¶

retourneer de resolutie (precisie) van de opgegeven klok clk_id., Refereer naarlock ID constanten voor een lijst van geaccepteerde waarden voor clk_id.

beschikbaarheid: Unix.

time.clock_gettime(clk_id) → float¶

retourneer de tijd van de opgegeven klok clk_id. Refereer naarlock ID constanten voor een lijst van geaccepteerde waarden voor clk_id.

beschikbaarheid: Unix.

time.clock_gettime_ns(clk_id) → int¶

vergelijkbaar met clock_gettime() maar retourneer de tijd als nanoseconden.

beschikbaarheid: Unix.

time.clock_settime(clk_id, time: float)¶

Stel de tijd van de opgegeven klok in clk_id. Momenteel isCLOCK_REALTIME de enige geaccepteerde waarde voor clk_id.

beschikbaarheid: Unix.

time.clock_settime_ns(clk_id, time: int)¶

vergelijkbaar met clock_settime() maar stel de tijd in met nanoseconden.

beschikbaarheid: Unix.

time.ctime()¶

converteer een tijd uitgedrukt in seconden sinds de epoch naar een tekenreeks van een vorm:'Sun Jun 20 23:21:05 1993' die de lokale tijd vertegenwoordigt. Het dagveld is twee tekens lang en is opgevuld als de dag een enkel cijfer is, bijvoorbeeld: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(naam)¶

Verkrijg informatie over de opgegeven klok als een namespace-object.,Ondersteund klok namen en de bijbehorende functies voor het lezen van hun valueare:

Het resultaat heeft de volgende attributen:

• instelbaar: True als de klok kan automatisch gewijzigd worden (bijv. door een NTP daemon) of met de hand door de systeem-administrateur, False anders

• uitvoering: De naam van de onderliggende C-functie gebruikt om getthe klok waarde. Refereer naar Clock ID constanten voor mogelijke waarden.,

• monotoon: True als de klok niet terug kan gaan,False anders

• resolutie: de resolutie van de klok in seconden (float)

time.gmtime()¶

converteer een tijd uitgedrukt in seconden sinds de epoch naar een struct_time inUTC waarin de DST-vlag altijd nul is. Als sec ’s niet worden gegeven ofNone, wordt de huidige tijd gebruikt zoals aangegeven door time()., Fractions of a second worden genegeerd. Zie hierboven voor een beschrijving van hetstruct_time object. Zie calendar.timegm() voor de inverse van deze functie.

time.localtime()¶

zoals gmtime() maar converteert naar lokale tijd. Als sec ’s niet worden gegeven ofNone, wordt de huidige tijd gebruikt zoals aangegeven door time(). De dstflag is ingesteld op 1 wanneer DST op de gegeven tijd van toepassing is.,

time.mktime(t)¶

Dit is de inverse functie van localtime(). Het argument is destruct_time of Volledige 9-tuple (aangezien de DST-vlag nodig is; gebruik -1als de DST-vlag als deze onbekend is) die de tijd in lokale tijd uitdrukt, notUTC. Het geeft een floating point getal terug, voor compatibiliteit met time().,Als de invoerwaarde niet kan worden weergegeven als een geldige tijd, zalOverflowError of ValueError worden verhoogd (dit hangt af van de vraag of de ongeldige waarde wordt opgevangen door Python of de onderliggende C-bibliotheken).De vroegste datum waarvoor het een tijd kan genereren is platformafhankelijk.

time.monotonic() → float¶

retourneer de waarde (in fractionele seconden) van een monotone klok, d.w.z. een klok die niet terug kan gaan. De klok wordt niet beïnvloed door updates van de systeemklok.,Het referentiepunt van de geretourneerde waarde is niet gedefinieerd, zodat alleen het verschil tussen de resultaten van opeenvolgende oproepen geldig is.

time.monotonic_ns() → int¶

vergelijkbaar met monotonic(), maar retourneer de tijd als nanoseconden.

time.perf_counter() → float¶

retourneer de waarde (in fractionele seconden) van een prestatieteller, d.w.z., aclock met de hoogst beschikbare resolutie om een korte duur te meten. Het omvat de tijd die tijdens de slaap is verstreken en is systeem-breed. Het referentiepunt van de geretourneerde waarde is niet gedefinieerd, zodat alleen het verschil tussen de resultaten van opeenvolgende oproepen geldig is.

time.perf_counter_ns() → int¶

vergelijkbaar met perf_counter(), maar retourneer de tijd als nanoseconden.

time.process_time() → float¶

retourneer de waarde (in fractionele seconden) van de som van de systeem-en gebruikerspu-tijd van het huidige proces. Het omvat niet de tijd die is verstreken tijdens de slaap. Het is per definitie proces-breed. Het referentiepunt van de geturnde waarde is niet gedefinieerd, zodat alleen het verschil tussen de resultaten van opeenvolgende oproepen geldig is.

time.process_time_ns() → int¶

vergelijkbaar met process_time() maar retourneertijd als nanoseconden.,

time.sleep(secs)¶

Onderbreek de uitvoering van de aanroepende thread gedurende het gegeven aantal seconden.Het argument kan een floating point getal zijn om een preciezere slaaptijd aan te geven. De werkelijke opschortingstijd kan korter zijn dan de gevraagde omdat elk vangsignaal de sleep() zal beëindigen na het uitvoeren van de vangroutine van dat signaal. Ook kan de opschortingstijd langer zijn dan door een willekeurige hoeveelheid wordt gevraagd vanwege de planning van andere activiteiten in het systeem.,

time.strftime(formaat)¶

converteer een tupel of struct_time die een tijd vertegenwoordigt zoals geretourneerd doorgmtime() of localtime() naar een tekenreeks zoals gespecificeerd door het formatargument. Als t niet is opgegeven, wordt de huidige tijd gebruikt zoals aangegeven doorlocaltime(). format moet een string zijn., ValueError Israëlisch indien een veld in t buiten het toegestane bereik valt.

0 is een juridisch argument voor elke positie in de tijd tupel; als het normaalillegaal is, wordt de waarde gedwongen tot een juiste.

de volgende richtlijnen kunnen worden ingebed in de format string., Ze zijn shownwithout de optionele velden breedte en precisie specificatie, en zijn replacedby de aangegeven tekens in de strftime() uitslag:

Opmerkingen:

1. Wanneer het gebruikt wordt met de strptime() functie de %p richtlijn alleen affectsthe output uur veld als de %I richtlijn wordt gebruikt voor het parseren van het uur.,

2. het bereik is in werkelijkheid 0 to 61; waarde 60 is valide intimestamps die schrikkelseconden vertegenwoordigen en waarde 61 wordt om historische redenen ondersteund.

3. bij gebruik met de functie strptime() worden %U en %W alleen increcaties gebruikt wanneer de dag van de week en het jaar zijn opgegeven.

Hier is een voorbeeld, een formaat voor datums die compatibel zijn met dat gespecificeerd in theRFC 2822 Internet email standard., 1

>>> from time import gmtime, strftime>>> strftime("%a, %d %b %Y %H:%M:%S +0000", gmtime())'Thu, 28 Jun 2001 14:17:15 +0000'

aanvullende richtlijnen kunnen op bepaalde platformen worden ondersteund, maar alleen de hier genoemde richtlijnen hebben een betekenis die is gestandaardiseerd door ANSI C. Om de volledige set van opmaak codes te zien die op uw platform worden ondersteund, raadpleeg de strftime(3)documentatie.

Op sommige platforms kan een optionele veldbreedte en precisiespecificatie onmiddellijk de initiële '%' van een richtlijn volgen in de volgende volgorde;Dit is ook niet overdraagbaar. De veldbreedte is normaal 2, behalve voor %j waar het 3 is.,

time.strptime(string)¶

ontleedt een string die een tijd vertegenwoordigt volgens een formaat. De retourwaarde is een struct_time zoals geretourneerd door gmtime() oflocaltime().

De opmaakparameter gebruikt dezelfde richtlijnen als die welke gebruikt worden doorstrftime(); standaard wordt "%a %b %d %H:%M:%S %Y" die overeenkomt met de opmaak die wordt geretourneerd door ctime(). Als de string niet volgens formaat kan worden ontleed, of als er teveel gegevens zijn na het ontleden, dan is ValueError israised., De standaardwaarden die worden gebruikt om ontbrekende gegevens in te vullen wanneer niet meer accurate waarden kunnen worden afgeleid, zijn (1900, 1, 1, 0, 0, 0, 0, 1, -1).Zowel string als format moeten strings zijn.

bijvoorbeeld:

Ondersteuning voor de%Z richtlijn is gebaseerd op de waarden intznameen ofdaylight waar is. Hierdoor is het platform-specifieke uitzondering voor het herkennen van UTC en GMT die altijd bekend zijn (en worden beschouwd als niet-Zomertijd tijdzones).

alleen de in de documentatie gespecificeerde richtlijnen worden ondersteund., Omdatstrftime() per platform wordt geïmplementeerd, kan het soms meerdirectives aanbieden dan de genoemde. Maar strptime() is onafhankelijk van elk platformen ondersteunt dus niet noodzakelijk alle beschikbare richtlijnen die niet zijn gedocumenteerd als ondersteund.

klassetime.struct_time¶

het type van de tijdwaardesequentie geretourneerd door gmtime(),localtime(), en strptime(). Het is een object met een namedtuple interface: waarden kunnen worden benaderd door index en attribuutnaam., De volgende waarden zijn aanwezig:

merk op dat in tegenstelling tot de C-structuur, de maandwaarde een bereik is van , niet.

In aanroepen naar mktime(), tm_isdst kan worden ingesteld op 1 wanneer de daglichtbesparingstijd van kracht is, en 0 wanneer dit niet het geval is. Een waarde van -1 geeft aan dat dit niet bekend is, en zal meestal resulteren in het invullen van de juiste status.

wanneer een tupel met een onjuiste lengte wordt doorgegeven aan een functie die eenstruct_time verwacht, of elementen van het verkeerde type heeft, wordt eenTypeError verhoogd.,

time.time() → float¶

retourneer de tijd in seconden sinds de epoch als een zwevend puntnummer. De specifieke datum van de epoch en de afhandeling vanleap seconden is platform afhankelijk.Op Windows en de meeste Unix-systemen is de epoch 1 januari 1970,00:00: 00 (UTC) en worden schrikkelseconden niet meegeteld voor de tijd in seconden sinds de epoch. Dit wordt gewoonlijk aangeduid alsunix time.To zoek uit wat de epoch is op een bepaald platform, kijk naargmtime(0).,

merk op dat hoewel de tijd altijd wordt geretourneerd als een zwevend puntnummer, niet alle systemen tijd met een betere precisie dan 1 seconde bieden.Hoewel deze functie normaal gesproken niet-dalende waarden retourneert, kan deze een lagere waarde retourneren dan een vorige oproep als de systeemklok tussen de twee oproepen is teruggezet.

het getal dat wordt geretourneerd door time() kan in UTC worden omgezet in een meer gebruikelijk tijdformaat (d.w.z. Jaar, Maand, Dag, uur, enz…) door het door te geven aangmtime() functie of in lokale tijd door het door te geven aan delocaltime() functie., In beide gevallen wordt eenstruct_time object geretourneerd, waaruit de componenten van de kalenderdatum kunnen worden benaderd als attributen.

time.thread_time() → float¶

retourneer de waarde (in fractionele seconden) van de som van de systeem-en gebruikerspu-tijd van de huidige thread. Het omvat niet de tijd die is verstreken tijdens de slaap. Het is per definitie draadspecifiek. Het referentiepunt van de geturnde waarde is niet gedefinieerd, zodat alleen het verschil tussen de resultaten van opeenvolgende oproepen in dezelfde thread geldig is.,

beschikbaarheid: Windows, Linux, Unix-systemen dieCLOCK_THREAD_CPUTIME_IDondersteunen.

time.thread_time_ns() → int¶

vergelijkbaar met thread_time() maar retourtijd als nanoseconden.

time.time_ns() → int¶

vergelijkbaar met time() maar geeft de tijd terug als een geheel getal van nanoseconden sinds de epoch.

time.tzset()¶

Reset de tijdconversieregels die door de bibliotheekroutines worden gebruikt. De omgevingsvariabele TZ geeft aan hoe dit wordt gedaan., Het zal ook de variabelentzname (van TZ omgevings variabele), timezone (niet-DSTseconds Westen van UTC), altzone (DST seconden westen van UTC) en daylight(op 0 als dit timezone heeft geen zomertijd regels, of tononzero als er een tijd, het verleden, heden of toekomst, wanneer de zomertijd timeapplies).

beschikbaarheid: Unix.,

het standaardformaat van de TZ omgevingsvariabele is (whitespaceded for clarity):

std offset , end]]]

waar de componenten zijn:

stdendst

drie of meer alfanumerieke tekens met de tijdzone-afkortingen. Deze zullen in de tijd worden voorgesteld.tzname

offset

De offset heeft de vorm: ± hh]. Dit geeft de toegevoegde waarde aan de lokale tijd om bij UTC aan te komen., Indien voorafgegaan door een’ -‘, is de tijdzone ten oosten van de nulmeridiaan; anders is het westen. Als er geen offset volgt, wordt aangenomen dat de Zomertijd een uur eerder is dan de standaardtijd.

start, end

geeft aan wanneer van en naar DST moet worden overgeschakeld. De opmaak van de begin-en einddatums is een van de volgende:

Jn

de Juliaanse dag n (1 <= n <= 365). Schrikkeldagen worden niet geteld, dus in alle jaren is 28 februari dag 59 en 1 maart dag 60.,

n

De op nul gebaseerde Juliaanse dag (0 <= n <= 365). Schrikkeldagen worden geteld, enhet is mogelijk om te verwijzen naar 29 februari.

Mm.n.d

time heeft hetzelfde formaat als offset behalve dat er geen leading sign(‘-‘ of ‘+’) is toegestaan. De standaard, als de tijd niet is opgegeven, is 02: 00: 00.

op veel Unix systemen (waaronder * BSD, Linux, Solaris en Darwin) is het nuttiger om de zoneinfo (tzfile(5)) database van het systeem te gebruiken om de tijdzone regels te specificeren., Om dit te doen, stelt u de TZ omgeving in die variabel is aan het pad van het vereiste Tijdzone databestand, relatief aan de root van de systeem ‘zoneinfo’ Tijdzone database, meestal op/usr/share/zoneinfo. Bijvoorbeeld: 'US/Eastern','Australia/Melbourne', 'Egypt' of 'Europe/Amsterdam'.

>>> os.environ = 'US/Eastern'>>> time.tzset()>>> time.tzname('EST', 'EDT')>>> os.environ = 'Egypt'>>> time.tzset()>>> time.tzname('EET', 'EEST')