timp – Timpul de acces și conversii¶

Funcții¶

time.asctime()¶

Converti un tuplu sau struct_time reprezintă un moment dat ca a revenit degmtime() sau localtime() la un șir de followingform: 'Sun Jun 20 23:21:05 1993'. Câmpul de zi este lung de două caractere și este captusit în spațiu dacă ziua este o singură cifră, de exemplu: 'Wed Jun 9 04:26:40 1993'.,

Dacă t nu este furnizat, se utilizează ora curentă returnată de localtime(). Informațiile Locale nu sunt utilizate de asctime().spre deosebire de funcția C cu același nume, asctime() nu adaugă atrailing newline.

time.pthread_getcpuclockid(thread_id)¶

se Întoarcă clk_id de firul specifice CPU-ceas de timp specificate thread_id.,

Utilizare threading.get_ident() sau identatributul de threading.Thread obiecte pentru a obține o potrivit valuefor thread_id.

disponibilitate: Unix(consultați pagina man pentru pthread_getcpuclockid (3) pentruinformații suplimentare).

time.clock_getres(clk_id)¶

se Întoarcă rezoluție (precizie) de specificat ceas clk_id., Consultați constantele ID de blocare pentru o listă de valori acceptate pentru clk_id.

disponibilitate: Unix.

time.clock_gettime(clk_id) → float¶

se Întoarcă de timp specificat ceas clk_id. Consultați constantele ID de blocare pentru o listă de valori acceptate pentru clk_id.

disponibilitate: Unix.

time.clock_gettime_ns(clk_id) → int¶

Similar cu clock_gettime() dar să se întoarcă de timp ca nanosecunde.

disponibilitate: Unix.

time.clock_settime(clk_id, ora: float)¶

Set de timp specificat ceas clk_id. În prezent,CLOCK_REALTIME este singura valoare acceptată pentru clk_id.

disponibilitate: Unix.

time.clock_settime_ns(clk_id, ora: int)¶

Similar cu clock_settime() dar seta timpul cu nanosecunde.

disponibilitate: Unix.

time.ctime()¶

Converti o dată și-a exprimat în secunde de la epocă la un șir de forma:'Sun Jun 20 23:21:05 1993' reprezentând ora locală. Câmpul de zi are două caractere și este captusit în spațiu dacă ziua este o singură cifră, de exemplu: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(nume)¶

Obțineți informații despre ceasul specificat ca obiect de spațiu de nume.,Sprijinit ceas denumirile și funcțiile corespunzătoare pentru a citi lor valueare:

rezultatul are următoarele atribute:

• reglabil: True dacă ceasul poate fi schimbat în mod automat (de exemplu, un NTP daemon) sau manual de către administratorul de sistem, False altfel

• aplicare: numele de fond al sistemului C funcția folosit pentru a face un ceas de valoare. Consultați constantele ID-ului ceasului pentru posibile valori.,

• monotonă: True dacă ceasul nu poate merge înapoi,False altfel

• rezoluție: rezoluție de ceas în câteva secunde (float)

time.gmtime()¶

Converti o dată și-a exprimat în secunde de la epocă la un struct_time inUTC în care dst pavilion este întotdeauna zero. Dacă secs nu este furnizat sauNone, se utilizează ora curentă returnată de time()., Fracțiunile de secundă sunt ignorate. A se vedea mai sus pentru o descriere astruct_time obiect. A se vedea calendar.timegm() pentru inversul thisfunction.

time.localtime()¶

gmtime() dar convertește la ora locală. Dacă secs nu este furnizat sauNone, se utilizează ora curentă returnată de time(). Dstflag este setat la 1 atunci când DST se aplică la timpul dat.,

time.mktime(t)¶

Aceasta este funcția inversă a localtime(). Argumentul său estestruct_time sau full 9-tuplu (de la dst de pavilion este necesar; utilizarea -1ca dst pavilion, dacă este necunoscut) care exprimă momentul în ora locală, notUTC. Returnează un număr în virgulă mobilă, pentru compatibilitate cu time().,Dacă valoarea de intrare nu poate fi reprezentat ca un valabile timp, fieOverflowError sau ValueError va fi mărită (de care depinde onwhether invalid valoare este prins de Piton sau de fond al sistemului biblioteci C).Cea mai veche dată pentru care poate genera un timp este dependentă de platformă.

time.monotonic() → float¶

Returna valoarea (în fracționată secunde) de o relație de ceas, adică un clockthat nu poate merge înapoi. Ceasul nu este afectat de actualizările ceasului de sistem.,Punctul de referință al valorii returnate este nedefinit, astfel încât numai diferența dintre rezultatele apelurilor consecutive este valabilă.

time.monotonic_ns() → int¶

Similar cu monotonic(), dar să se întoarcă de timp ca nanosecunde.

time.perf_counter() → float¶

Returna valoarea (în fracționată secunde) de un performance counter, adică, aclock cu cea mai mare rezoluție disponibilă pentru a măsura o durată scurtă. Itdoes include timpul scurs în timpul somnului și este la nivel de sistem. Punctul de referință al valorii returnate este nedefinit, astfel încât numai diferența dintrerezultatele apelurilor consecutive este valabilă.

time.perf_counter_ns() → int¶

Similar cu perf_counter(), dar să se întoarcă de timp ca nanosecunde.

time.process_time() → float¶

Returna valoarea (în fracționată secunde) din suma de sistem și userCPU timpul procesului de curent. Nu include timpul scurs în timpulsomn. Este prin definiție la nivel de proces. Punctul de referință al valorii returnate este nedefinit, astfel încât numai diferența dintre rezultatele apelurilor consecutive este validă.

time.process_time_ns() → int¶

Similar cu process_time() dar să se întoarcă de timp ca nanosecunde.,

time.sleep(secs)¶

Suspenda executarea firul de asteptare pentru un anumit număr de secunde.Argumentul poate fi un număr de virgulă mobilă pentru a indica un somn mai precis. Suspendare efectivă de timp poate fi mai mică decât cea solicitată pentru anycaught semnal va rezilia sleep() în urma executării thatsignal e prinderea de rutină. De asemenea, timpul de suspendare poate fi mai lung decâtcerută de o sumă arbitrară din cauza programării altor activități în sistem.,

time.strftime(format)¶

Converti un tuplu sau struct_time reprezintă un moment dat ca a revenit degmtime() sau localtime() la un șir de caractere specificat de formatargument. Dacă t nu este furnizat, se utilizează ora curentă returnată delocaltime(). formatul trebuie să fie un șir., ValueError isrised dacă orice câmp din t este în afara intervalului permis.

0 este un argument juridic pentru orice poziție în timp tuplu; dacă este normallyillegal valoarea este forțată la una corectă.următoarele directive pot fi încorporate în șirul de format., Acestea sunt shownwithout de câmp opțional lățime și precizie în caietul de sarcini, și sunt replacedby indicat personajele din strftime() rezultat:

Note:

1. atunci Când este utilizat cu strptime() funcția, %p directiva numai affectsthe ieșire oră câmp dacă %I directiva este folosită pentru a analiza oră.,

2. gama este într-adevăr 0 și 61; valoarea 60 este valabil intimestamps reprezentând un salt de secunde și valoarea 61 este supportedfor motive istorice.

3. atunci Când este utilizat cu strptime() funcția %U și %W sunt folosite doar incalculations când ziua din săptămână și an sunt specificate.

aici este un exemplu, un format pentru datele compatibile cu cea specificată în 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'

Suplimentare directivele pot fi sprijinite pe anumite platforme, dar numai ¶ cele enumerate aici au o semnificație standardizat de ANSI C. Pentru a vedea complet setof format de coduri acceptate pe platforma dvs., consultați strftime(3)documentația.

Pe unele platforme, un câmp opțional lățime și precizie în caietul de sarcini canimmediately urmați inițială '%' unei directive în ordinea următoare;acest lucru este, de asemenea, portabil. Lățimea câmpului este în mod normal 2, cu excepția %j unde este 3.,

time.strptime(string)¶

Analiza un șir de caractere reprezentând un moment potrivit unui format. Revenirea valoareeste un struct_time ca a revenit de gmtime() saulocaltime().

parametrul format utilizează aceleași directive ca cele utilizate de cătrestrftime(); implicit este "%a %b %d %H:%M:%S %Y" care se potrivește theformatting returnate de către ctime(). Dacă șirul nu poate fi analizat în funcție de format, sau dacă are date în exces după analiză, ValueError israised., Valorile implicite utilizate pentru a completa orice date lipsă atunci când valorile moreaccurate nu pot fi deduse sunt (1900, 1, 1, 0, 0, 0, 0, 1, -1).Atât șirul, cât și formatul trebuie să fie șiruri de caractere.

De exemplu:

Suport pentru %Z directiva se bazează pe valorile cuprinse în tznameși dacă daylight este adevărat. Din acest motiv, este specific platformei, cu excepția recunoașterii UTC și GMT, care sunt întotdeauna cunoscute (și sunt considerate a fi fusuri orare non-vară).numai directivele specificate în documentație sunt acceptate., Deoarecestrftime() este implementat pe platformă, uneori poate oferi mai multe direcții decât cele listate. Dar strptime() este independent de orice platformand astfel nu acceptă în mod obligatoriu toate directivele disponibile, care sunt notdocumented fi acceptate.

clasatime.struct_time¶

tipul de valoarea în timp secvență returnate de către gmtime(),localtime() și strptime(). Este un obiect cu o interfață namedtuple: valorile pot fi accesate prin index și prin numele atributului., Valorile următoare sunt prezente:

rețineți că, spre deosebire de structura C, valoarea lunii este un interval de , nu.

În apeluri la mktime(), tm_isdst poate fi setat la 1 atunci când daylightsavings timp este în vigoare, și de 0 atunci când nu este. O valoare de -1 indică faptul căacest lucru nu este cunoscut și, de obicei, va duce la completarea stării corecte.

atunci Când un tuplu cu o lungime incorectă a trecut la o funcție așteaptă unstruct_time, sau având elemente de tip greșit, unTypeError este ridicat.,

time.time() → float¶

se Întoarcă în timp, în secunde, de la epocă ca un plutitor pointnumber. Data specifică a epocii și manevrareasecunde ieftine este dependentă de platformă.Pe Windows și majoritatea sistemelor Unix, Epoca este 1 ianuarie 1970,00:00:00 (UTC), iar secundele de salt nu sunt luate în considerare pentru timpîn secunde de la epocă. Acest lucru este denumit în mod obișnuit asUnix timp.Pentru a afla ce epoca este pe o anumită platformă, uita-te lagmtime(0).,rețineți că, deși timpul este întotdeauna returnat ca punct flotantnumăr, nu toate sistemele oferă timp cu o precizie mai bună decât 1 secundă.În timp ce această funcție returnează în mod normal valori care nu scad, poate returna o valoare mai mică decât un apel anterior dacă ceasul de sistem a fost setat între cele două apeluri.

numărul returnat de time() poate fi transformată într-o mai commontime format (de exemplu, anul, luna, ziua, ora, etc…) în UTC, prin trecerea lagmtime() funcția sau în ora locală prin trecerea lalocaltime() function., În ambele cazuri, un obiectstruct_time este returnat, din care componentele datei calendaristice pot fi accesate ca atribute.

time.thread_time() → float¶

Returna valoarea (în fracționată secunde) din suma de sistem și userCPU timp de firul curent. Nu include timpul scurs în timpulsomn. Este specific firului prin definiție. Punctul de referință al valorii returnate este nedefinit, astfel încât numai diferența dintre rezultatele apelurilor consecutive din același thread este validă.,

disponibilitate: sisteme Windows, Linux, Unix care suportăCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

Similar cu thread_time() dar să se întoarcă de timp ca nanosecunde.

time.time_ns() → int¶

Similar cu time() dar se întoarce în timp ca un număr întreg de nanosecondssince epoca.

time.tzset()¶

Resetați regulile de conversie a timpului utilizate de rutinele bibliotecii. Environmentvariable TZ specifică modul în care se face acest lucru., Acesta va stabili, de asemenea, variabiletzname (de la TZ variabila de mediu), timezone (non-DSTseconds Vest al UTC), altzone (DST secunde vest al UTC) și daylight(cu 0 dacă acest orar nu are nici lumina zilei de economisire de timp, norme, sau tononzero dacă există un timp, trecut, prezent sau viitor, atunci când lumina zilei de economisire de timeapplies).

disponibilitate: Unix.,

formatul standard al TZ variabila de mediu este (whitespaceadded pentru claritate):

std offset , end]]]

în cazul în Care componentele sunt:

stdșidst

Trei sau mai multe alfanumerice oferindu-zona de fus orar abrevieri. Acestea vor fi propuse în timp.tzname

offset

offset are forma: ± hh]. Aceasta indică valoareaadăugat ora locală pentru a ajunge la UTC., Dacă este precedat de un” -„, fusuleste la est de meridianul principal; în caz contrar, este spre vest. Dacă nu urmează nici o compensațiedst, se presupune că ora de vară este cu o oră înainte de Ora standard.

start, end

indică când să schimbați la și înapoi de la DST. Formatul de thestart și de încheiere sunt următoarele:

Jn

ziua Julian n (1 <= n <= 365). Zilele de salt nu sunt numărate, deci întoți anii 28 februarie este ziua 59, iar 1 martie este ziua 60.,

n

zero-based Julian zi (0 <= n <= 365). Zilele de salt sunt numărate șiEste posibil să se facă referire la 29 februarie.

Mm.n.d

time are același format ca offset cu excepția faptului că nici un lider de semn(‘-‘ sau ‘+’) este permis. Valoarea implicită, dacă timpul nu este dat, este 02:00:00.

Pe multe sisteme Unix (inclusiv *BSD, Linux, Solaris, și Darwin), este moreconvenient să utilizeze sistemul e zoneinfo (tzfile(5)) de baze de date tospecify fusul orar reguli., Pentru a face acest lucru, setați TZ environmentvariable la calea necesară de fus orar netware, relativ la rădăcină al sistemelor de zoneinfo’ baza de date de fus orar, de obicei, situat la/usr/share/zoneinfo. De exemplu, 'US/Eastern','Australia/Melbourne', 'Egypt' sau 'Europe/Amsterdam'.

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