Funktioner¶

time.asctime()¶

Konvertere en tupel eller struct_time repræsenterer en tid, som returneres afgmtime() eller localtime() til en streng af followingform: 'Sun Jun 20 23:21:05 1993'. Feltet dag er to tegn longand er plads polstret, hvis dagen er et enkelt ciffer,f'Wed Jun 9 04:26:40 1993'.,

Hvis t ikke er angivet, bruges den aktuelle tid som returneret af localtime(). Locale information bruges ikke af asctime().

Bemærk

i modsætning til C-funktionen med samme navn tilføjerasctime() ikke atrailing ne .line.

time.pthread_getcpuclockid(thread_id)¶

Returnere clk_id af den tråd-specifik CPU-ur til den angivne thread_id.,

Brug threading.get_ident() eller identattribut i threading.Thread objekter for at få en passende valuefor thread_id.

advarsel

Hvis du passerer en ugyldig eller udløbet thread_id, kan det resultere i udefineret adfærd, såsom segmenteringsfejl.

tilgængelighed: Uni. (se man-siden for pthread_getcpuclockid(3) For yderligere oplysninger).

nyt i version 3.7.

time.clock_getres(clk_id) returner opløsningen (præcisionen) for det specificerede ur clk_id., Se toClock ID Konstanter for en liste over accepterede værdier for clk_id.

tilgængelighed: Uni..

nyt i version 3.3.

time.clock_gettime(clk_id). float returner tidspunktet for det angivne ur clk_id. Se toClock ID Konstanter for en liste over accepterede værdier for clk_id.

tilgængelighed: Uni..

nyt i version 3.3.

time.clock_gettime_ns(clk_id) → int¶

der Ligner clock_gettime() men vender tilbage gang som nanosekunder.

tilgængelighed: Uni..

nyt i version 3.7.,

time.clock_settime(clk_id, time: float) Indstil tidspunktet for det angivne ur clk_id. I øjeblikket erCLOCK_REALTIMEden eneste accepterede værdi for clk_id.

tilgængelighed: Uni..

nyt i version 3.3.

time.clock_settime_ns(clk_id, tid: int)¶

der Ligner clock_settime() men sæt tid med nanosekunder.

tilgængelighed: Uni..

nyt i version 3.7.,

time.ctime()¶

Konverterer et tidspunkt udtrykt i sekunder siden epoken til en streng af en formular:'Sun Jun 20 23:21:05 1993' repræsenterer lokal tid. Dagsfeltet er to tegn langt og er pladspolstret, hvis dagen er et enkelt ciffer,f.eks.: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(navn) Get

få oplysninger om det angivne ur som et navneområdeobjekt.,Understøttet ur navne og de tilhørende funktioner til at læse deres valueare:

resultatet har følgende attributter:

  • justerbar: True hvis uret kan ændres automatisk (fx afen NTP-dæmonen), eller manuelt af systemadministratoren, False andet

  • gennemførelse: navn på den underliggende C-funktion, der bruges til at getthe ur-værdi. Se Clock ID konstanter for mulige værdier.,

  • monoton: True hvis uret ikke gå tilbage,False andet

  • opløsning: opløsning af uret i sekunder (float)

Nyt i version 3.3.

time.gmtime()¶

Konverterer et tidspunkt udtrykt i sekunder siden epoken til en struct_time inUTC, hvor dst flag er altid nul. Hvis secs ikke er angivet ellerNone, bruges den aktuelle tid som returneret af time()., Fraktioneraf et sekund ignoreres. Se ovenfor for en beskrivelse afstruct_time objekt. Se calendar.timegm() for den inverse af thisfunction.

time.localtime()¶

Som gmtime() men konverterer de til lokal tid. Hvis secs ikke er angivet ellerNone, bruges den aktuelle tid som returneret af time(). Dstflag er indstillet til 1 når DST gælder for den givne tid.,

time.mktime(t)¶

Dette er den inverse funktion af localtime(). Dets argument erstruct_time eller Fuld 9-tuple (da dst-flag er nødvendigt; brug -1som dst-flag, hvis det er ukendt), der udtrykker tiden i lokal tid, notUTC. Det returnerer et flydende punktnummer for kompatibilitet med time().,Hvis inputværdien ikke kan repræsenteres som en gyldig tid, hæves entenOverflowError eller ValueError (hvilket afhænger af, om den ugyldige værdi er fanget af Python eller de underliggende C-biblioteker).Den tidligste dato, for hvilken det kan generere en tid, er platformafhængig.

time.monotonic() float float returner værdien (i brøkdele sekunder) af et monotont ur, dvs.et ur, der ikke kan gå baglæns. Uret påvirkes ikke af systemuropdateringer.,Referencepunktet for den returnerede værdi er udefineret, så kunforskellen mellem resultaterne af på hinanden følgende opkald er gyldig.

nyt i version 3.3.

ændret i version 3.5: funktionen er nu altid tilgængelig og altid hele systemet.

time.monotonic_ns() → int¶

der Ligner monotonic(), men vender tilbage gang som nanosekunder.

nyt i version 3.7.

time.perf_counter() float float returner værdien (i brøkdele sekunder) af en ydelsestæller, dvs., aclock med den højeste tilgængelige opløsning til at måle en kort varighed. Det omfatter tid gået under søvn og er hele systemet. Referencepunktet for den returnerede værdi er udefineret, så kun forskellen mellemresultaterne af fortløbende opkald er gyldige.

nyt i version 3.3.

time.perf_counter_ns() → int¶

der Ligner perf_counter(), men vender tilbage gang som nanosekunder.

nyt i version 3.7.,

time.process_time() → float¶

Returnerer værdien (i brøkdele af sekunder) af summen af systemet og userCPU tid for den aktuelle proces. Det omfatter ikke tid, der er gået undersøvn. Det er proces-dækkende per definition. Referencepunktet for den omregnede værdi er udefineret, således at kun forskellen mellem resultaterne af fortløbende opkald er gyldig.

nyt i version 3.3.

time.process_time_ns() → int¶

der Ligner process_time() men vender tilbage gang som nanosekunder.,

nyt i version 3.7.

time.sleep(sek)¶

Suspendere gennemførelsen af den kaldende tråd, for et givet antal sekunder.Argumentet kan være et flydende punktnummer for at indikere en mere præcis søvntid. Den faktiske suspensionstid kan være mindre end den, der anmodes om, fordi anycaught-signalet vil afslutte sleep() efter udførelse af thatsignals fangstrutine. Suspensionstiden kan også være længere endkrævet af et vilkårligt beløb på grund af planlægningen af anden aktiviteti systemet.,

ændret i version 3.5: funktionen sover nu mindst sek, selvom søvnen afbrydes af et signal, undtagen hvis signalhåndtereren rejser en undtagelse (seePEP 475 for begrundelsen).

time.strftime(format)¶

Konvertere en tupel eller struct_time repræsenterer en tid, som returneres afgmtime() eller localtime() til en string, som er angivet af formatargument. Hvis t ikke er angivet, bruges den aktuelle tid som returneret aflocaltime(). format skal være en streng., ValueError israiseret, hvis et felt i t er uden for det tilladte område.

0 er et juridisk argument for enhver position i tiden tupel; hvis det er normaltuloval værdien er tvunget til en korrekt.

følgende direktiver kan indlejres i formatstrengen., De er shownwithout den valgfrie felt bredde og præcision specifikation, og er replacedby de angivne tegn i strftime() resultat:

Bemærk:

  1. Når den bruges med strptime() funktion, %p direktiv kun affectsthe output time felt, hvis %I direktiv bruges til at parse time.,

  2. vifte virkelig er 0 til 61 værdi 60 er gyldig intimestamps repræsenterer spring sekunder og værdi 61 er supportedfor historiske årsager.

  3. Når den bruges med strptime() funktion %U og %W kun anvendes incalculations, når den dag i ugen, og år er angivet.

Her er et eksempel, et format for datoer kompatibelt med det, der er angivet i theRFC 2822 Internet e-mail 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'

Yderligere direktiver kan være understøttet på bestemte platforme, men kun theones, der er anført her har en betydning, standardiseret af ANSI C. for At se den fulde setof format koder, der understøttes af din platform, høre strftime(3)dokumentation.

På nogle platforme, et valgfrit felt, bredde og præcision specifikation canimmediately følge den oprindelige '%' af et direktiv, i følgende rækkefølge;dette er heller ikke bærbare. Feltbredden er normalt 2 undtagen %j hvor er 3.,

time.strptime(string)¶

Parse en streng, der repræsenterer en tid i henhold til et format. Afkastet valueis struct_time som returneres af gmtime() ellerlocaltime().

parameteren format bruger de samme direktiver, som dem, der anvendes afstrftime(); den er som standard "%a %b %d %H:%M:%S %Y", som matcher theformatting tilbage med ctime(). Hvis string ikke kan analyseres i overensstemmelse med formatet, eller hvis den har overskydende data efter parsing, ValueError israised., Standardværdierne, der bruges til at udfylde manglende data, når der ikke kan udledes mere nøjagtige værdier, er (1900, 1, 1, 0, 0, 0, 0, 1, -1).Både streng og format skal være strenge.

For eksempel:

Støtte til %Z direktiv er baseret på de værdier, der er indeholdt i tznameog om daylight er sand. På grund af dette, er det platform-specificeceptcept for anerkendelse UTC og GMT, som altid er kendt (og anses for at være ikke-sommertid tids Timoner).

kun de direktiver, der er angivet i dokumentationen, understøttes., Fordistrftime() implementeres pr. Men strptime() er uafhængig af enhver platformog understøtter således ikke nødvendigvis alle tilgængelige direktiver, der ikke er dokumenterede som understøttet.

klassetime.struct_time

hvilken type af den tidsmæssige værdi sekvens, der returneres af gmtime()localtime() og strptime(). Det er et objekt med en namedtuple interface: værdier kan tilgås af indeks og ved attribut navn., Denfølgende værdier er til stede:

Bemærk, at i modsætning til C-strukturen er månedens værdi en række , ikke.

I mktime() tm_isdst kan være indstillet til 1, når daylightsavings tidspunkt er i kraft, og 0, når det er det ikke. En værdi på -1 angiver detdette er ikke kendt, og vil normalt resultere i, at den korrekte tilstand udfyldes.

Når en tupel med en forkert længde er gået til en funktion, der forventer enstruct_time, eller som har elementer af den forkerte type, enTypeError er hævet.,

time.time() float float returner tiden i sekunder siden epoken som et flydende punktnummer. Den specifikke Dato for epoken og håndteringen AFAP sekunder er platformafhængig.På Windowsindo .s og de fleste Uni. – systemer er epoken 1. januar 1970,00:00:00 (UTC), og spring sekunder tælles ikke med tiden i sekunder siden epoken. Dette kaldes almindeligvis uniun time.To find ud af, hvad epoken er på en given platform, se pågmtime(0).,

Bemærk, at selvom tiden altid returneres som et flydende punktnummer, giver ikke alle systemer tid med en bedre præcision end 1 sekund.Selvom denne funktion normalt returnerer ikke-faldende værdier, kan den returnere en lavere værdi end et tidligere opkald, hvis systemuret er indstillet backbetbetweeneen de to opkald.

Det tal, der returneres af time() kan omdannes til et mere commontime format (dvs år, måned, dag, time, osv….), UTC ved at overføre det tilgmtime() funktion eller i lokal tid ved at sende det tillocaltime() funktion., I begge tilfælde returneres etstruct_time objekt, hvorfra komponenterne i kalenderdatoen kan tilgås som attributter.

time.thread_time() float float returner værdien (i brøkdele sekunder) af summen af systemet og brugercpu tid for den aktuelle tråd. Det omfatter ikke tid, der er gået undersøvn. Det er tråd-specifik per definition. Referencepunktet for den omregnede værdi er udefineret, således at kun forskellen mellem resultaterne af fortløbende opkald i samme tråd er gyldig.,tilgængelighed: Availabilityindo .s, Linu., Uni. – systemer, der understøtterCLOCK_THREAD_CPUTIME_ID.

nyt i version 3.7.

time.thread_time_ns() → int¶

der Ligner thread_time() men vender tilbage gang som nanosekunder.

nyt i version 3.7.

time.time_ns() → int¶

der Ligner time() men returnerer en integer antallet af nanosecondssince epoke.

nyt i version 3.7.,

time.tzset() Reset

Nulstil reglerne for tidskonvertering, der bruges af bibliotekets rutiner. The environmentvariable TZ angiver, hvordan dette gøres., Det vil også sætte de variablertzname (fra TZ miljø-variabel), timezone (ikke-DSTseconds Vest for UTC), altzone (DST sekunder vest for UTC) og daylight(0, hvis dette tidszone, der ikke har nogen sommertid regler, eller tononzero hvis der er en tid, fortid, nutid eller fremtid, når sommertid timeapplies).

tilgængelighed: Uni..,

Bemærk!

Selv om der i mange tilfælde kan ændre TZ miljø-variabel mayaffect produktionen af funktioner som f.eks. localtime() uden at kaldetzset(), dette problem bør ikke påberåbes.

TZ miljøvariablen bør ikke indeholde mellemrum.,

standard format TZ miljø-variabel er (whitespaceadded for klarhedens skyld):

std offset , end]]]

Hvor komponenter er:

stdogdst

Tre eller flere alfanumeriske tegn, der giver den tidszone forkortelser. Disse vil blive propageret til tiden.tzname

offset

offset har følgende form: ± hh]. Dette indikerer værditilvæksten den lokale tid til at nå frem til UTC., Hvis der går forud for en’ -‘, er tidszonen øst for den primære Meridian; ellers er den vest. Hvis ingen forskydning follodsdst, sommertid antages at være en time forud for standard tid.

start, end

angiver, hvornår der skal skiftes til og tilbage fra DST. Formatet af thestart-og slutdatoer er en af følgende:

Jn

Den Julianske dag n (1 <= n <= 365). Leap dage tælles ikke, så ialle år 28. Februar er dag 59 og 1.Marts er dag 60.,

n

nul-baserede Julian day (0 <= n <= 365). Leap dage tælles, ogDet er muligt at henvise til 29.februar.

Mm.n.d

time har samme format som offset bortset fra, at ingen af de ledende tegn(‘-‘ eller ‘+’) er tilladt. Standard, hvis tiden ikke er givet, er 02: 00: 00.

På mange Unix-systemer (herunder *BSD, Linux, Solaris, og Darwin), det er moreconvenient til at bruge systemets zoneinfo (tzfile(5)) database tospecify tidszone regler., For at gøre dette, skal du indstille TZ environmentvariable til stien til den ønskede tidszone datafil, i forhold til roden af systemer ‘zoneinfo’ tidszone-database, som oftest er placeret i/usr/share/zoneinfo. For eksempel: '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')