tidsåtkomst och konverteringar¶

funktioner¶

time.asctime()¶

konvertera en tuple eller struct_time representerar en tid som returneras avgmtime() eller localtime() till en sträng i följande formulär: 'Sun Jun 20 23:21:05 1993'. Dagfältet är två tecken långoch är Utrymme vadderat om dagen är en enda siffra, t.ex.: 'Wed Jun 9 04:26:40 1993'.,

om t inte tillhandahålls används den aktuella tiden som returneras av localtime(). Lokalinformation används inte av asctime().

time.pthread_getcpuclockid(thread_id)¶

returnera clk_id för den trådspecifika CPU-tidsklockan för den angivna thread_id.,

användthreading.get_ident() elleridentattribut förthreading.Thread objekt för att få ett lämpligt värdeför thread_id.

tillgänglighet: Unix (se manualsidan för pthread_getcpuclockid(3) för ytterligare information).

time.clock_getres(clk_id)¶

returnera upplösningen (precision) för den angivna klockan clk_id., Se toClock ID Konstanter för en lista över godkända värden för clk_id.

tillgänglighet: Unix.

time.clock_gettime(clk_id) → float¶

returnera tiden för den angivna klockan clk_id. Se toClock ID Konstanter för en lista över godkända värden för clk_id.

tillgänglighet: Unix.

time.clock_gettime_ns(clk_id) → int¶

liknar clock_gettime() men returtid som nanosekunder.

tillgänglighet: Unix.

time.clock_settime(clk_id, time: float)¶

Ställ in tiden för den angivna klockan clk_id. För närvarande ärCLOCK_REALTIME det enda godkända värdet för clk_id.

tillgänglighet: Unix.

time.clock_settime_ns(clk_id, time: int)¶

liknar clock_settime() men inställd tid med nanosekunder.

tillgänglighet: Unix.

time.ctime()¶

konvertera en tid uttryckt i sekunder sedan epoken till en sträng av ett formulär:'Sun Jun 20 23:21:05 1993' representerar lokal tid. Dagen fieldis två tecken långa och är Utrymme vadderad om dagen är en enda siffra,t.ex.: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(namn)¶

få information om den angivna klockan som ett namnområdesobjekt.,Stöds klocknamn och motsvarande funktioner för att läsa deras valueare:

resultatet har följande attribut:

• justerbar: True om klockan kan ändras automatiskt (t.ex. bya NTP-demonen) eller manuellt av systemadministratören, False annars

• implementering: namnet på den underliggande C-funktionen kan ändras automatiskt. används för att få klockvärdet. Se klock-ID-konstanter för möjliga värden.,

• monotonisk:True om klockan inte kan gå bakåt,False annars

• upplösning: upplösningen av klockan på några sekunder (float)

time.gmtime()¶

konvertera en tid uttryckt i sekunder sedan epoken till enstruct_time inUTC där DST-flaggan alltid är noll. Om secs inte tillhandahålls ellerNone används den aktuella tiden som returneras av time()., Fraktioner av en sekund ignoreras. Se ovan för en beskrivning av objektetstruct_time. Secalendar.timegm() för inversen av denna funktion.

time.localtime()¶

gillagmtime() men konverterar till lokal tid. Om secs inte tillhandahålls ellerNone används den aktuella tiden som returneras av time(). Dstflag är inställt på 1 när DST gäller den angivna tiden.,

time.mktime(t)¶

detta är den inverse funktionen för localtime(). Dess argument ärstruct_time eller full 9-tuple (eftersom DST-flaggan behövs; använd -1som DST-flaggan om den är okänd) som uttrycker tiden i lokal tid, notUTC. Den returnerar ett flyttal, för kompatibilitet med time().,Om inmatningsvärdet inte kan representeras som en giltig tid kommer antingenOverflowError ellerValueError att höjas (vilket beror påom det ogiltiga värdet fångas av Python eller de underliggande C-biblioteken).Det tidigaste datumet för vilket det kan generera en tid är plattformsberoende.

time.monotonic() → float¶

returnera värdet (i fraktionerade sekunder) för en monotonisk klocka, dvs. en klocka som inte kan gå bakåt. Klockan påverkas inte av systemklockuppdateringar.,Referenspunkten för det returnerade värdet är odefinierad, så att endast skillnaden mellan resultaten av på varandra följande samtal är giltig.

time.monotonic_ns() → int¶

liknar monotonic(), men returtid som nanosekunder.

time.perf_counter() → float¶

returnera värdet (i fraktionerade sekunder) för en prestandaräknare, dvs., aclock med högsta tillgängliga upplösning för att mäta en kort varaktighet. Itdoes inkluderar tid som förflutit under sömnen och är systemomfattande. Hänvisningen till det returnerade värdet är odefinierad, så att endast skillnaden mellan resultaten av på varandra följande samtal är giltig.

time.perf_counter_ns() → int¶

liknar perf_counter(), men returtid som nanosekunder.

time.process_time() → float¶

returnera värdet (i fraktionerade sekunder) av summan av systemet och userCPU tiden för den aktuella processen. Det inkluderar inte tid som förflutit undersömn. Det är processomfattande per definition. Referenspunkten för det aktuella värdet är odefinierad, så att endast skillnaden mellan resultaten av på varandra följande samtal är giltig.

time.process_time_ns() → int¶

liknar process_time() men returtid som nanosekunder.,

time.sleep(secs)¶

Avbryt utförandet av den uppringande tråden för det angivna antalet sekunder.Argumentet kan vara ett flyttal för att indikera en mer exakt sömntid. Den faktiska avstängningstiden kan vara mindre än den begärda eftersom anycaught-signalen kommer att avsluta sleep() efter utförandet av thatsignal fångstrutin. Suspensionstiden kan också vara längre änkrävs av en godtycklig mängd på grund av schemaläggning av annan aktivitet i systemet.,

time.strftime(format)¶

konvertera en tuple ellerstruct_time representerar en tid som returneras avgmtime() ellerlocaltime() till en sträng som specificeras av formaterargumentet. Om t inte tillhandahålls används den aktuella tiden som returneras avlocaltime(). formatet måste vara en sträng., ValueError israiseras om något fält i t ligger utanför det tillåtna intervallet.

0 är ett juridiskt argument för vilken position som helst under tiden.om det är normalt sett olagligt måste värdet vara korrekt.

följande direktiv kan bäddas in i formatsträngen., De visas utan den valfria fältbredden och precisionsspecifikationen och ersätts av de angivna tecknen i strftime() – resultatet:

anmärkningar:

1. när de används med funktionen strptime() påverkar %p – direktivet endast fältet output hour om fältet %I direktivet används för att tolka timmen.,

2. intervallet är verkligen 0 till 61; värde 60 är giltiga intimestamps som representerar skottsekunder och värde 61 stöds av historiska skäl.

3. När den används med funktionen strptime()används %Uoch %W endast iberäkningar när veckodagen och året anges.

här är ett exempel, ett format för datum som är kompatibelt med det som anges i theRFC 2822 Internet e-poststandard., 1

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

ytterligare direktiv kan stödjas på vissa plattformar, men endast de som listas här har en betydelse som standardiseras av ANSI C. För att se hela setof-formatkoderna som stöds på din plattform, se strftime-dokumentationen(3).

på vissa plattformar kan en valfri fältbredd och precisionsspecifikation omedelbart följa den ursprungliga'%' I ett direktiv i följande ordning;det här är inte heller bärbart. Fältbredden är normalt 2 utom %j därDet är 3.,

time.strptime(string)¶

tolka en sträng som representerar en tid enligt ett format. Returvärdet är ett struct_timesom returneras avgmtime()ellerlocaltime().

formatparametern använder samma direktiv som de som används av strftime(); det är som standard "%a %b %d %H:%M:%S %Y" som matchar denformatering som returneras av ctime(). Om strängen inte kan analyseras accordingto-format, eller om den har överskjutande data efter Tolkning, ValueError israised., De standardvärden som används för att fylla i saknade data när moreaccurate värden inte kan härledas är (1900, 1, 1, 0, 0, 0, 0, 1, -1).Både sträng och format måste vara strängar.

till exempel:

stöd för%Z – direktivet baseras på värdena itznameoch omdaylight är sant. På grund av detta är det plattformsspecifikexcept för att känna igen UTC och GMT som alltid är kända (och anses vara tillfria tidszoner).

endast de direktiv som anges i dokumentationen stöds., Eftersomstrftime() implementeras per plattform kan det ibland erbjuda flerdirektiver än de som listas. Men strptime() är oberoende av alla plattformaroch stöder därför inte nödvändigtvis alla tillgängliga direktiv som inte är dokumenterade som stödda.

klasstime.struct_time¶

typen av tidsvärdessekvens som returneras av gmtime(),localtime() och strptime(). Det är ett objekt med ett namntuple-gränssnitt: värden kan nås med index och med attributnamn., Följande värden finns:

Observera att till skillnad från C-strukturen är månadsvärdet ett intervall av, inte.

i samtal tillmktime(),tm_isdst kan ställas in på 1 när daylightsavings tid är i kraft, och 0 när det inte är det. Ett värde på -1 indikerar detDetta är inte känt, och kommer vanligtvis att resultera i att rätt tillstånd fylls i.

när en tupel med felaktig längd skickas till en funktion som förväntar sig enstruct_time, eller har element av fel typ, höjs enTypeError.,

time.time() → float¶

returnera tiden på några sekunder sedan epoken som flyttal. Det specifika datumet för epoken och hanteringen avlöp sekunder är plattformsberoende.På Windows och de flesta Unix-system är epoken 1 januari 1970,00: 00: 00 (UTC) och språngsekunder räknas inte mot tideni sekunder sedan epoken. Detta kallas vanligen asUnix time.To ta reda på vad epoken är på en given plattform, titta pågmtime(0).,

Observera att även om tiden alltid returneras som ett flyttal, ger inte alla system tid med bättre precision än 1 sekund.Medan den här funktionen normalt returnerar icke-minskande värden kan den returnera högre värde än ett tidigare samtal om systemklockan har ställts in mellan de två samtalen.

numret som returneras avtime() kan omvandlas till ett mer commontime-format (dvs. År, Månad, Dag, timme, etc…) I UTC genom att skicka det tillgmtime() – funktionen eller i lokal tid genom att skicka det till funktionenlocaltime()., I båda fallen returneras ettstruct_time – objekt, från vilket komponenternaav kalenderdatumet kan nås som attribut.

time.thread_time() → float¶

returnera värdet (i fraktionerade sekunder) av summan av systemet och userCPU tiden för den aktuella tråden. Det inkluderar inte tid som förflutit undersömn. Det är trådspecifikt per definition. Referenspunkten för det aktuella värdet är odefinierad, så att endast skillnaden mellan resultaten av på varandra följande samtal i samma tråd är giltig.,

tillgänglighet: Windows, Linux, Unix-system som stöderCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

liknar thread_time() men returtid som nanosekunder.

time.time_ns() → int¶

liknar time() men returnerar tid som ett heltal antal nanosecondssince epoken.

time.tzset()¶

Återställ de tidskonverteringsregler som används av bibliotekets rutiner. Den environmentvariableTZ anger hur detta görs., Det kommer också att ställa in variablertzname (från TZ miljövariabel), timezone (icke-DSTseconds Väster om UTC), altzone (DST sekunder väster om UTC) och daylight(till 0 om denna tidszon har inte någon sommartid regler, eller tononzero om det finns en tid, dåtid, nutid eller framtid när sommartid timeapplies).

tillgänglighet: Unix.,

standardformatet för miljövariabelnTZ är (vit för tydlighetens skull):

std offset , end]]]

där komponenterna är:

stdochdst

tre eller fler alfanumerier som ger tidszon förkortningar. Dessa kommer att försättas i tid.tzname

offset

förskjutningen har formen: ± hh]. Detta indikerar värdetillsatte den lokala tiden för att komma fram till UTC., Om föregås av en” -”, tidszonär öster om den främsta meridianen; annars är den väst. Om ingen förskjutning följerförst antas sommartid vara en timme före standardtid.

start, end

anger när du ska byta till och tillbaka från DST. Formatet för thestart och slutdatum är ett av följande:

Jn

den julianska dagen n (1 <= n <= 365). Skottdagar räknas inte, så ialla år 28 februari är dag 59 och 1 mars är dag 60.,

n

den nollbaserade Julian day (0<= n<= 365). Skottdagar räknas, ochDet är möjligt att hänvisa till 29 februari.

Mm.n.d

time har samma format som offset förutom att inget ledande tecken(’-’ eller ’+’) är tillåtet. Standardvärdet, om tiden inte anges, är 02: 00: 00.

På många Unix-system (inklusive *BSD, Linux, Solaris och Darwin), det är moreconvenient att använda systemets zoneinfo (tzfile(5)) databas tospecify tidszon regler., För att göra detta, ställ inTZ environmentvariable till sökvägen för den tidszon som krävs datafil, i förhållande till roten av systemen ’zoneinfo’ tidszon databas, vanligtvis ligger på/usr/share/zoneinfo. Till exempel 'US/Eastern','Australia/Melbourne', 'Egypt' eller 'Europe/Amsterdam'.

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