– tid-tilgang og konverteringer¶

Funksjoner¶

time.asctime()¶

Konvertere en tuple eller struct_time representerer en tid som returneres avgmtime() eller localtime() til en streng av followingform: 'Sun Jun 20 23:21:05 1993'. Dagen felt er to tegn longand er plass polstret om dagen er et enkelt tall,for eksempel: 'Wed Jun 9 04:26:40 1993'.,

Hvis t er ikke gitt, gjeldende klokkeslett som returneres av localtime()brukes. Nasjonale innstillinger opplysninger ikke brukes av asctime().

time.pthread_getcpuclockid(thread_id)¶

gå Tilbake clk_id av tråden-spesifikke CPU-tid klokke for den angitte thread_id.,

Bruk threading.get_ident() eller identegenskap av threading.Thread gjenstander for å få en egnet valuefor thread_id.

Tilgjengelighet: Unix (se man-siden for pthread_getcpuclockid(3) forfurther informasjon).

time.clock_getres(clk_id)¶

gå Tilbake oppløsning (presisjon) for den angitte klokke clk_id., Se toClock ID Konstanter for en liste over godkjente verdier for clk_id.

Tilgjengelighet: Unix.

time.clock_gettime(clk_id) → flyte¶

gå Tilbake tidspunktet for den angitte klokke clk_id. Se toClock ID Konstanter for en liste over godkjente verdier for clk_id.

Tilgjengelighet: Unix.

time.clock_gettime_ns(clk_id) → int¶

Lik clock_gettime() men gå tilbake i tid som nanosekunder.

Tilgjengelighet: Unix.

time.clock_settime(clk_id, tid: float)¶

Angi tidspunktet for den angitte klokke clk_id. ForeløpigCLOCK_REALTIME er den eneste verdien som aksepteres for clk_id.

Tilgjengelighet: Unix.

time.clock_settime_ns(clk_id, tid: int)¶

Lik clock_settime() men du angi klokkeslett med nanosekunder.

Tilgjengelighet: Unix.

time.ctime()¶

Konvertere en tid uttrykt i sekunder siden epoke til en streng av en form:'Sun Jun 20 23:21:05 1993' som representerer lokal tid. Dagen fieldis to tegn langt, og det er plass polstret om dagen er et enkelt tall,for eksempel: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(navn)¶

Få informasjon på den angitte klokke som et navnerom objekt.,Støttet klokke navnene og funksjonene til å lese deres valueare:

resultatet har følgende egenskaper:

• justerbar: True hvis klokken kan bli endret automatisk (f.eks. bya NTP daemon) eller manuelt av systemadministratoren, False annet

• gjennomføring: navnet på den underliggende C-funksjonen brukes til å getthe klokke verdi. Se Klokke ID Konstanter for mulige verdier.,

• monotonic: True hvis klokken ikke gå bakover,False annet

• oppløsning: oppløsning av klokken i sekunder (float)

time.gmtime()¶

Konvertere en tid uttrykt i sekunder siden epoke til en struct_time inUTC der sommertid flagg er alltid null. Hvis sekunder er ikke gitt ellerNone, gjeldende klokkeslett som returneres av time() brukes., Fractionsof andre er ignorert. Se ovenfor for en beskrivelse avstruct_time objekt. Se calendar.timegm() for den inverse av thisfunction.

time.localtime()¶

Som gmtime() men konverterer den til lokal tid. Hvis sekunder er ikke gitt ellerNone, gjeldende klokkeslett som returneres av time() brukes. Den dstflag er satt til 1 når SOMMERTID gjelder for den tid.,

time.mktime(t)¶

Dette er den inverse funksjonen av localtime(). Argument erstruct_time eller full 9-tuple (siden sommertid flagg er nødvendig, bruk -1som sommertid flagg hvis det er ukjent) som uttrykker den tiden lokal tid, notUTC. Det gir en flytende punkt nummer, for kompatibilitet med time().,Hvis input verdien kan ikke være representert som en gyldig tid, entenOverflowError eller ValueError vil bli hevet (som avhenger av onwhether ugyldig verdi er fanget av Python eller underliggende C-bibliotek).Den tidligste datoen for som det kan generere en gang er plattform-avhengige.

time.monotonic() → flyte¶

Returnere verdien (i brøkdeler av sekunder) av en monotonic klokke, dvs. en clockthat kan ikke gå bakover. Klokken er ikke påvirket av systemklokken oppdateringer.,Referanse punkt på den returnerte verdien er udefinert, slik at bare thedifference mellom resultatet i etterfølgende samtaler er gyldig.

time.monotonic_ns() → int¶

Lik monotonic(), men gå tilbake i tid som nanosekunder.

time.perf_counter() → flyte¶

Returnere verdien (i brøkdeler av sekunder) av en ytelse counter, dvs., aclock med den høyeste oppløsningen for å måle en kort varighet. Itdoes inkluderer tiden som har gått under søvn og er system-wide. Den referencepoint av verdien som returneres er udefinert, slik at bare den forskjellen betweenthe resultatene av påfølgende anrop er gyldig.

time.perf_counter_ns() → int¶

Lik perf_counter(), men gå tilbake i tid som nanosekunder.

time.process_time() → flyte¶

Returnere verdien (i brøkdeler av sekunder) av summen av systemet og userCPU tid av den aktuelle prosessen. Det inkluderer ikke tiden som har gått duringsleep. Det er prosess-bred definisjon. Referansepunktet av thereturned verdi er udefinert, slik at bare forskjellen mellom resultsof påfølgende anrop er gyldig.

time.process_time_ns() → int¶

Lik process_time() men gå tilbake i tid som nanosekunder.,

time.sleep(sek)¶

Suspendere gjennomføringen av kalle tråden for gitt antall sekunder.Argumentet kan være et flytende punkt nummer for å angi en mer presis sleeptime (dvaletid). Den faktiske suspensjon tid kan være mindre enn det som er etterspurt fordi anycaught signal vil avslutte sleep() følgende utførelse av thatsignal er å fange rutine. Også, suspensjon tid kan være lengre thanrequested ved et vilkårlig beløp på grunn av planlegging av andre activityin systemet.,

time.strftime(format)¶

Konvertere en tuple eller struct_time representerer en tid som returneres avgmtime() eller localtime() til en streng som er angitt av formatargument. Hvis t er ikke gitt, gjeldende klokkeslett som returneres avlocaltime() brukes. formatet må være en streng., ValueError israised hvis feltet i t er utenfor tillatt område.

0 er en juridisk argument for enhver posisjon i gang tuple; hvis det er normallyillegal verdien er tvunget til en riktig ett.

følgende direktiver kan være innebygd i formatstrengen., De er shownwithout det valgfritt felt bredde og presisjon spesifikasjon, og er replacedby den angitte tegn i strftime() resultat:

Merk:

1. Når den brukes med strptime() funksjon, %p direktivet bare affectsthe utgang time hvis feltet %I direktivet er brukt til å analysere time.,

2. området virkelig er 0 til 61; verdi 60 er gyldig intimestamps som representerer sprang sekunder og verdi 61 er supportedfor historiske årsaker.

3. Når den brukes med strptime() funksjon %U og %W blir bare brukt incalculations når den dag i uken og året er angitt.

Her er et eksempel, et format for datoer som er kompatible med det som er angitt i theRFC 2822 Internett-e-post-standarden., 1

– >

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

Flere direktiver kan støttes på enkelte plattformer, men bare theones som er oppført her, har en mening standardisert av ANSI C. for Å se det i full setof format-koder støttes på plattformen, se strftime(3)dokumentasjon.

På noen plattformer, et valgfritt felt bredde og presisjon spesifikasjon canimmediately følge den første '%' i et direktiv i følgende rekkefølge;dette er heller ikke bærbar. Feltets bredde er normalt 2 unntatt for %j whereit er 3.,

time.strptime(string)¶

Parse en streng som representerer en tid i henhold til en-format. Tilbake valueis en struct_time som returneres av gmtime() ellerlocaltime().

format parameteren bruker de samme direktiver som de som brukes avstrftime(); det er som standard "%a %b %d %H:%M:%S %Y" som matcher theformatting returneres av ctime(). Hvis strengen ikke kan analyseres accordingto format, eller hvis det har overflødig data etter parsing, ValueError israised., Standard verdier som brukes til å fylle ut manglende data når moreaccurate verdier som ikke kan utledes av disse er (1900, 1, 1, 0, 0, 0, 0, 1, -1).Både streng og formatet må være strenger.

For eksempel slik:

Støtte for %Z direktivet er basert på de verdier som finnes i tznameog om daylight er sant. På grunn av dette, det er plattform-specificexcept for å gjenkjenne UTC (GMT) som er alltid kjent (og er ansett som tobe ikke-sommertid tidssoner).

Bare direktivene som er angitt i dokumentasjonen er støttet., Fordistrftime() er implementert per plattform, kan det noen ganger tilbyr moredirectives enn de som er nevnt. Men strptime() er uavhengige av alle platformand dermed ikke nødvendigvis støtte alle direktiver som er notdocumented som støttes.

klassentime.struct_time¶

Den type av tidsverdien sekvens som returneres av gmtime(),localtime(), og strptime(). Det er et objekt med en namedtuple grensesnitt: verdier som kan nås av indeksen, og av attributtet navn., Thefollowing verdier finnes:

Merk at i motsetning til C-strukturen, måned verdien er en rekke , ikke.

I samtaler til mktime(), tm_isdst kan settes til 1 når daylightsavings tid er i effekt, og 0 når det ikke er. Verdien -1 betyr thatthis er ikke kjent, og vil vanligvis resultere i riktig tilstand blir fylt ut.

Når en tuple med feil lengde er gått over til en funksjon som forventer enstruct_time, eller har elementer av feil type, enTypeError er hevet.,

time.time() → flyte¶

gå Tilbake i tid i sekunder siden den epoken som et flytende pointnumber. Den spesifikke datoen for den epoken og håndtering ofleap sekunder er plattform-avhengig.På Windows og de fleste Unix-systemer, den epoken er 1. januar, 1970,00:00:00 (UTC) og sprang sekunder telles ikke mot klokkeslett sekunder siden den epoken. Dette er ofte referert til asUnix tid.For å finne ut hva den epoken er på en gitt plattform, se pågmtime(0).,

Merk at selv om tiden er alltid returneres som en flytende pointnumber, ikke alle systemer sørger for tiden med en bedre presisjon enn 1 sekund.Mens denne funksjonen returnerer normalt ikke synkende verdier, det kan gå tilbake alower verdi enn en tidligere samtale hvis systemet klokken har blitt satt backbetween de to samtalene.

antall returnerte som time() kan konverteres til en mer commontime format (dvs. år, måned, dag, time, etc…) i UTC ved å sende den tilgmtime() funksjon eller i lokal tid ved å sende den tillocaltime() funksjon., I begge tilfeller enstruct_time objektet er returnert, som componentsof kalenderen dato kan benyttes som attributter.

time.thread_time() → flyte¶

Returnere verdien (i brøkdeler av sekunder) av summen av systemet og userCPU tid av den aktuelle tråden. Det inkluderer ikke tiden som har gått duringsleep. Det er thread-bestemt av definisjonen. Referansepunktet av thereturned verdi er udefinert, slik at bare forskjellen mellom resultsof påfølgende samtaler i samme tråd som er gyldig.,

Tilgjengelighet: Windows, Linux, Unix-systemer som støtterCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

Lik thread_time() men gå tilbake i tid som nanosekunder.

time.time_ns() → int¶

Lik time() men tilbake gang som et heltall antall nanosecondssince den epoken.

time.tzset()¶

du vil Tilbakestille tiden konvertering regler som brukes ved biblioteket rutiner. Den environmentvariable TZ angir hvordan dette er gjort., Det vil også sett variablenetzname (av TZ miljø-variabelen), timezone (ikke-DSTseconds Vest for UTC), altzone (DST sekunder vest for UTC) og daylight(til 0 hvis dette tidssone ikke har noen sommertid-regler, eller tononzero hvis det er en tid, fortid, nåtid eller fremtid når sommertid timeapplies).

Tilgjengelighet: Unix.,

standard format av TZ miljø-variabelen (whitespaceadded for klarhet):

– >

std offset , end]]]

Hvor komponentene er:

stdogdst

Tre eller flere alphanumerics å gi tidssone forkortelser. Disse vil bepropagated i tid.tzname

offset

offset har formen: ± hh]. Dette indikerer verdiskapende lokal tid å komme frem til UTC., Hvis innledes med en ‘-‘, den timezoneis øst for nullmeridianen; ellers er det vest. Hvis ingen offset followsdst, sommeren er antatt å være en time i forkant av standard tid.

start, end

Indikerer når du skal endre til og tilbake fra SOMMERTID. Formatet på thestart-og sluttdato er ett av de følgende:

Jn

Den Julianske dag n (1 <= n <= 365). Leap dager telles ikke, så inall år 28. februar er dagen 59 og 1. Mars er dagen 60.,

n

null-basert Julian dag (0 <= n <= 365). Leap dager telles, andit er mulig å referere til 29 februar.

Mm.n.d

time har samme format som offset bortsett fra at ingen fører logg(‘-‘ eller ‘+’) er tillatt. Standard, hvis tid er ikke gitt, er 02:00:00.

På mange Unix-systemer (inkludert *BSD, Linux, Solaris, og Darwin), det er moreconvenient å bruke systemets zoneinfo (tzfile(5)) database tospecify tidssonen regler., For å gjøre dette, setter TZ environmentvariable til banen av de nødvendige tidssone datafile, i forhold til rot-ofthe-systemer ‘zoneinfo’ tidssone database, som vanligvis er plassert på/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')