čas – Time přístup a konverze¶

Funkce¶

time.asctime()¶

Převést na n-tice, nebo struct_time představuje čas jako vrácenégmtime() nebo localtime() řetězec followingform: 'Sun Jun 20 23:21:05 1993'. Den pole dva znaky dlouhoa je prostor polstrovaný případě, že den je jedna číslice,např.: 'Wed Jun 9 04:26:40 1993'.,

Pokud není k dispozici t, použije se aktuální čas vrácený localtime(). Informace o národním prostředí nejsou používány asctime().

time.pthread_getcpuclockid(thread_id)¶

Návrat na clk_id závitu-konkrétní CPU-time hodiny pro zadaný thread_id.,

Použití threading.get_ident() nebo identatribut threading.Thread objekty, aby si vhodný prostředků thread_id.

dostupnost: Unix (viz stránka man pro pthread_getcpuclockid (3) další informace).

time.clock_getres(clk_id)¶

vraťte Rozlišení (Přesnost) zadaných hodin clk_id., Viz toClock ID konstanty pro seznam přijatých hodnot pro clk_id.

dostupnost: Unix.

time.clock_gettime(clk_id) → float¶

Návrat době stanovené hodiny clk_id. Viz toClock ID konstanty pro seznam přijatých hodnot pro clk_id.

dostupnost: Unix.

time.clock_gettime_ns(clk_id) → int¶

Podobné clock_gettime(), ale vrátit čas jako nanosekund.

dostupnost: Unix.

time.clock_settime(clk_id, čas: float)¶

Nastavte čas pro zadané hodiny clk_id. V současné době jeCLOCK_REALTIME jedinou akceptovanou hodnotou pro clk_id.

dostupnost: Unix.

time.clock_settime_ns(clk_id, čas: int)¶

Podobné clock_settime(), ale nastavit čas s nanosekund.

dostupnost: Unix.

time.ctime()¶

Převést čas vyjádřený v sekundách od začátku epochy na řetězec formuláře:'Sun Jun 20 23:21:05 1993' představující místního času. Denní poleje dva znaky dlouhé a je prostor polstrovaný, pokud je den jedinou číslicí, např.: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(name)¶

získejte informace o zadaných hodinách jako objektu jmenného prostoru.,Podporované hodiny jména a odpovídající funkce pro čtení jejich valueare:

výsledek má následující atributy:

• nastavitelný: True pokud hodiny může být změněn automaticky (např. bya NTP daemon), nebo ručně správcem systému, False jinak

• provedení: název podkladového C funkce používá dostaneme hodiny hodnotu. Možné hodnoty naleznete v konstantách ID hodin.,

• monotónní: True pokud hodiny nemohou jít zpětFalse jinak

• rozlišení: rozlišení hodiny za několik sekund (float)

time.gmtime()¶

Převést čas vyjádřený v sekundách od začátku epochy do struct_time inUTC, ve kterém dst vlajka je vždy nula. Pokud secs není k dispozici neboNone, použije se aktuální čas vrácený time()., Zlomky sekundy jsou ignorovány. Viz výše pro popisstruct_time objekt. Viz calendar.timegm() pro inverzní funkce.

time.localtime()¶

Jako gmtime(), ale převádí na místní čas. Pokud secs není k dispozici neboNone, použije se aktuální čas vrácený time(). Dstflag je nastaven na 1, pokud DST platí pro daný čas.,

time.mktime(t)¶

Toto je inverzní funkce localtime(). Jeho argument jestruct_time nebo full 9-tice (od dst vlajku je potřeba; použít -1jako dst vlajku pokud to není známo), které vyjadřuje čas v místním čase, notUTC. Vrací číslo s plovoucí desetinnou čárkou, pro kompatibilitu s time().,Pokud je vstupní hodnota nemůže být reprezentován jako platný čas, buďOverflowError nebo ValueError bude zvýšena (což závisí onwhether neplatná hodnota je chycen Python nebo základní C knihovny).Nejčasnější datum, pro které může generovat čas, je závislé na platformě.

time.monotonic() → float¶

Vrátí hodnotu (ve zlomcích sekundy) monotónní hodiny, tj. clockthat nemůže jít zpět. Hodiny nejsou ovlivněny aktualizací systémových hodin.,Referenční bod vrácené hodnoty je nedefinován, takže je platný pouze rozdíl mezi výsledky po sobě jdoucích hovorů.

time.monotonic_ns() → int¶

Podobné monotonic(), ale vrátit čas jako nanosekund.

time.perf_counter() → float¶

vraťte hodnotu (ve zlomkových sekundách) čítače výkonu, tj., aclock s nejvyšším dostupným rozlišením pro měření krátké doby trvání. Itdoes zahrnují čas uplynulý během spánku a je systémově široký. Odkaz na vrácenou hodnotu není definován, takže je platný pouze rozdíl mezi výsledky po sobě jdoucích hovorů.

time.perf_counter_ns() → int¶

Podobné perf_counter(), ale vrátit čas jako nanosekund.

time.process_time() → float¶

Vrátí hodnotu (ve zlomcích sekundy) součet systém a userCPU čas aktuální proces. Nezahrnuje čas, který uplynul běhemspát. Podle definice je celoplošná. Referenční bod hodnoty je nedefinován, takže je platný pouze rozdíl mezi výsledkyposledních hovorů.

time.process_time_ns() → int¶

Podobné process_time(), ale vrátit čas jako nanosekund.,

time.sleep(v sekundách)¶

Pozastavit provádění volající vlákno na daný počet sekund.Argumentem může být číslo s plovoucí desetinnou čárkou, které označuje přesnější dobu spánku. Skutečná doba pozastavení může být menší než požadovaná, protože signál anycaught ukončí sleep() po provedení rutiny chytání thatsignalu. Také doba pozastavení může být delší nežpožadované libovolnou částkou kvůli plánování jiné aktivityv systému.,

time.strftime(formát)¶

Převést na n-tice, nebo struct_time představuje čas jako vrácenégmtime() nebo localtime() řetězec tak, jak stanoví formatargument. Pokud není k dispozici t, použije se aktuální čas vrácenýlocaltime(). formát musí být řetězec., ValueError je-li jakékoli pole v t mimo povolený rozsah.

0 je právní argument pro jakoukoli pozici v časovém Tice; pokud je normálněprávní hodnota je nucena ke správnému.

následující směrnice mohou být vloženy do řetězce formátu., Jsou shownwithout nepovinné pole šířka a přesné specifikace, a jsou nahrazena uvedených znaků v strftime() výsledek:

Poznámky:

1. Při použití strptime() funkce, %p směrnice pouze affectsthe výstup hodinu pole, pokud %I směrnice slouží k analýze hodinu.,

2. rozsah je opravdu 0 61; hodnota 60 je platný intimestamps představující přestupné sekundy a hodnoty 61 je supportedfor historických důvodů.

3. Při použití strptime() funkce %U %W jsou použity pouze incalculations, když se den v týdnu a rok jsou uvedeny.

Zde je příklad formátu pro data kompatibilní s je uvedeno v theRFC 2822 e-mailu sítě Internet 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'

Další směrnice mohou být podporovány na některých platformách, ale jen theones jsou zde uvedeny, mají význam standardizován ANSI C. Pro zobrazení v plné setof kódy formátu podporované na platformě, konzultovat strftime(3)dokumentace.

Na některých platformách, nepovinné pole šířka a přesné specifikace canimmediately následovat počáteční '%' směrnice v následujícím pořadí;to je také není přenosný. Šířka pole je obvykle 2 s výjimkou %j whereit je 3.,

time.strptime(string)¶

Analyzovat řetězec představující čas podle formátu. Návratová hodnotaje struct_time vráceno gmtime() nebolocaltime().

formát parametr používá stejné směrnice jako ty, které používajístrftime(); výchozí hodnota je "%a %b %d %H:%M:%S %Y", který odpovídá formátování vrátil do ctime(). Pokud řetězec nelze analyzovat podle formátu, nebo má-li po analýze nadbytečná data, ValueError., Výchozí hodnoty použité k vyplnění chybějících dat, pokud nelze odvodit hodnoty moreaccurate, jsou (1900, 1, 1, 0, 0, 0, 0, 1, -1).Řetězec i formát musí být řetězce.

například:

Podpora pro %Z směrnice je založena na hodnotách obsažených v tznamea to, zda daylight je pravda. Z tohoto důvodu je to platforma specificexcept pro rozpoznávání UTC a GMT, které jsou vždy známé (a jsou považovány za Časové pásmo bez letního světla).

jsou podporovány pouze směrnice uvedené v dokumentaci., Protožestrftime() je implementován na platformu, může někdy nabídnout více než ty uvedené. Ale strptime() je nezávislý na jakékoli platforměa proto nemusí nutně podporovat všechny dostupné směrnice, které nejsou dokumentovány jako podporované.

třídatime.struct_time¶

typ časové hodnoty sekvence vrácené gmtime()localtime() strptime(). Jedná se o objekt s jménemtuple rozhraní: hodnoty lze přistupovat podle indexu a podle názvu atributu., Následující hodnoty jsou přítomny:

Všimněte si, že na rozdíl od struktury C je hodnota měsíce rozsah, ne.

volání do mktime() tm_isdst může být nastaven na 1, když daylightsavings čas je v platnosti, a 0 pokud není. Hodnota -1 to naznačujeto není známo a obvykle bude mít za následek vyplnění správného stavu.

je-li n-tice s nesprávnou délkou předána funkci, která očekávástruct_time, nebo má prvky nesprávného typu, je zvýšenaTypeError.,

time.time() → float¶

Návrat na čas v sekundách od začátku epochy jako plovoucí pointnumber. Konkrétní datum epochy a vyřízení sekund je závislé na platformě.Na Windows a většinu Unixových systémů, epocha je 1. ledna, 1970,00:00:00 (UTC) a přestupné sekundy nejsou započítány do času sekund od epochy. To se běžně označuje jako asUnix time.To zjistěte, co je epocha na dané platformě, podívejte se nagmtime(0).,

Všimněte si, že i když čas je vždy vrácena jako plovoucí pointnumber, ne všechny systémy poskytují čas s lepší přesností než 1 sekundu.Zatímco tato funkce obvykle vrací neklesající hodnoty, může vrátit hodnotu alower než předchozí hovor, pokud byly systémové hodiny nastaveny mezi dvěma hovory.

počet vrácených time() mohou být převedeny do více commontime formátu (tj. rok, měsíc, den, hodina, atd…) v UTC předánímgmtime() funkce nebo na místní čas tím, že projde dolocaltime() funkce., V obou případech je vrácen objektstruct_time, ze kterého mohou být komponenty kalendářního data přístupné jako atributy.

time.thread_time() → float¶

Vrátí hodnotu (ve zlomcích sekundy) součet systém a userCPU době aktuální vlákno. Nezahrnuje čas, který uplynul běhemspát. Je to vlákno specifické podle definice. Referenční bod hodnoty je nedefinován, takže je platný pouze rozdíl mezi výsledkyposledních hovorů ve stejném vlákně.,

dostupnost: Windows, Linux, unixové systémy podporující CLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

Podobné thread_time(), ale vrátit čas jako nanosekund.

time.time_ns() → int¶

Podobné time(), ale vrátí čas jako celé číslo nanosecondssince epochy.

time.tzset()¶

resetujte pravidla pro konverzi času používaná rutinami knihovny. Prostředí TZ určuje, jak se to dělá., To bude také nastavit proměnnétzname (z TZ proměnné prostředí), timezone (non-DSTseconds Západně od UTC), altzone (DST sekund západně od UTC) a daylight(0, pokud toto pásmo nemá žádné pravidla letního času, nebo tononzero pokud je čas, minulost, přítomnost nebo budoucnost, když letní timeapplies).

dostupnost: Unix.,

standardní formát TZ proměnné prostředí je (whitespaceadded pro přehlednost):

std offset , end]]]

Kde jsou složky:

stddst

Tři nebo více algoritmy dávat časové pásmo zkratky. Ty budou časem upraveny.tzname

offset

offset má tvar: ± hh]. To označuje hodnotu místního času, který dorazí do UTC., Pokud předchází“ -„, Časové pásmyje východně od hlavního poledníku; jinak je západ. Pokud nedojde k posunu, předpokládá se, že letní čas je o hodinu před standardním časem.

start, end

označuje, kdy se má změnit na a zpět z DST. Formát začátku a koncová data jsou následující:

Jn

Julian day n (1 <= n <= 365). Přestupné dny se nepočítají, takže vvšechny roky 28. února je den 59 a 1. března je den 60.,

n

nulový Juliánský den (0 < = n < = 365). Přestupné dny jsou počítány aJe možné odkazovat na 29. února.

Mm.n.d

time má stejný formát jako offset kromě toho, že žádná vedoucí znamení(‚-‚ nebo ‚+‘) je povoleno. Výchozí, pokud není uveden čas, je 02: 00: 00.

Na mnoha Unixových systémech (včetně *BSD, Linux, Solaris, a Darwin), je moreconvenient použití systému zoneinfo (tzfile(5)) databáze tospecify timezone pravidla., K tomu, nastavte TZ environmentvariable na cestu požadované časové pásmo datafile, relativní k kořenové systémy z ‚zoneinfo časové pásmo databáze, obvykle se nachází v/usr/share/zoneinfo. Například 'US/Eastern''Australia/Melbourne' 'Egypt' nebo 'Europe/Amsterdam'.

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