– aikaa – Aikaa-yhteys ja muunnokset¶

Toiminnot¶

time.asctime()¶

Muuntaa monikko tai struct_time eli aika palauttaagmtime() tai localtime() merkkijono ja followingform: 'Sun Jun 20 23:21:05 1993'. Päivä-kentässä on kaksi merkkiä pitkä ja on tilaa pehmustettu jos päivä on yksittäinen numero,esim: 'Wed Jun 9 04:26:40 1993'.,

Jos t ei ole säädetty, nykyinen aika, niin palautetaan localtime()käytetään. Paikkatietoa ei käytä asctime().

time.pthread_getcpuclockid(thread_id)¶

Palauta clk_id lanka-erityinen CPU-aikaa kello määritelty thread_id.,

Käyttö threading.get_ident() tai identominaisuus threading.Thread esineitä saada sopiva vastine thread_id.

Saatavuus: Unix (katso man-sivulta pthread_getcpuclockid(3) asiasta lisätietoja).

time.clock_getres(clk_id)¶

Palauta resoluutio (tarkkuus) määritetyn kello clk_id., Katso toClock ID-vakiot luettelosta hyväksytyistä arvoista clk_id.

saatavuus: Unix.

time.clock_gettime(clk_id) → float¶

Palaa, kun määritetty kello clk_id. Katso toClock ID-vakiot luettelosta hyväksytyistä arvoista clk_id.

saatavuus: Unix.

time.clock_gettime_ns(clk_id) → int¶

Samanlainen clock_gettime() mutta palaa aikaa kuin nanosekuntia.

saatavuus: Unix.

time.clock_settime(clk_id, aika: float)¶

Aseta aika määritetyn kello clk_id. Tällä hetkellä,CLOCK_REALTIME on ainoa hyväksytty arvo clk_id.

saatavuus: Unix.

time.clock_settime_ns(clk_id, kertaa: int)¶

Samanlainen clock_settime() mutta asettaa aikaa nanosekuntia.

saatavuus: Unix.

time.ctime()¶

Muunna aika ilmaistaan sekunteina koska aikakauden merkkijono muodossa:'Sun Jun 20 23:21:05 1993' edustaa paikallista aikaa. Päivä fieldis kaksi merkkiä pitkä ja on tilaa pehmustettu jos päivä on yksittäinen numero,esim: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(nimi)¶

Saada tietoa tietyn kellon nimiavaruus kohde.,Tuetut kello nimet ja vastaavat toiminnot lukea heidän valueare:

tuloksena on seuraavat määritteet:

• säädettävä: True jos kello voidaan muuttaa automaattisesti (esim. bia NTP daemon) tai manuaalisesti järjestelmän pääkäyttäjä, False muuten

• toteutus: nimen taustalla C-toiminto käyttää tule kellon arvo. Katso kellotunnisteen vakiot mahdollisista arvoista.,

• monotoninen: True jos kello ei voi mennä taaksepäin,False muuten

• resoluutio: resoluutio kellon sekuntia (float)

time.gmtime()¶

Muunna aika ilmaistaan sekunteina koska aikakauden struct_time inUTC jossa dst lippu on aina nolla. Jos sekuntia ei ole säädetty taiNone nykyinen aikaa kuin palautetaan time() käytetään., Sekunnin murto-osia ei oteta huomioon. Katso yllä olevastastruct_time objektin kuvaus. Ks. calendar.timegm() tämän funktion käänteispuolella.

time.localtime()¶

Kuten gmtime() mutta muuntaa paikallista aikaa. Jos sekuntia ei ole säädetty taiNone nykyinen aikaa kuin palautetaan time() käytetään. Dstflag asetetaan arvoon 1, kun DST koskee annettua aikaa.,

time.mktime(t)¶

Tämä on käänteinen toiminto localtime(). Sen argumentti onstruct_time tai koko 9-monikko (koska dst lippu tarvitaan; käytä -1kuten dst lippu, jos se on tuntematon), joka ilmaisee aikaa, paikallista aikaa, notUTC. Se palauttaa kelluvan pistenumeron yhteensopivuuden time()kanssa.,Jos tulon arvo ei voi olla esittää voimassa oleva aika, jokoOverflowError tai ValueError nostetaan (joka riippuu onwhether pätemätön arvo on kiinni Python tai taustalla C-kirjastot).Varhaisin päivämäärä, jolle se voi luoda aikaa, on alustariippuvainen.

time.monotonic() → float¶

Paluu arvo (fractional sekuntia) on monotoninen kello, eli clockthat ei voi mennä taaksepäin. Järjestelmän kellopäivitykset eivät vaikuta kelloon.,Palautusarvon vertailupiste on määrittelemätön, joten vain peräkkäisten puhelujen tulosten välinen ero on pätevä.

time.monotonic_ns() → int¶

Samanlainen monotonic(), mutta palaa aikaa kuin nanosekuntia.

time.perf_counter() → float¶

Paluu arvo (fractional sekuntia) suorituskykyä laskuri, eli, aclock, jolla on korkein käytettävissä oleva resoluutio lyhyen keston mittaamiseksi. Itdoes sisältää unen aikana kuluneen ajan ja se on järjestelmän laajuinen. Palautetun arvon viitearvo on määrittelemätön, joten vain peräkkäisten puhelujen tulosten välinen ero on voimassa.

time.perf_counter_ns() → int¶

Samanlainen perf_counter(), mutta palaa aikaa kuin nanosekuntia.

time.process_time() → float¶

Paluu arvo (fractional sekuntia) summa järjestelmä ja userCPU aikaa meneillään. Siihen ei sisälly aikaa, joka kului uniunessa. Se on määritelmän mukaan prosessin laajuinen. Viitepiste thereturned value on määrittelemätön, joten vain ero peräkkäisten puhelujen tulosten välillä on voimassa.

time.process_time_ns() → int¶

Samanlainen process_time() mutta palaa aikaa kuin nanosekuntia.,

time.sleep(sekuntia)¶

Keskeyttää suorituksen kutsuvan lanka tietyn määrän sekuntia.Argumentti voi olla kelluva pistenumero, joka kertoo tarkemmasta nukkumisajasta. Todellinen jousitus aika voi olla pienempi kuin pyydetty, koska anycaught signaali lopettaa sleep() seuraavat suorittamisen thatsignal on kiinni rutiini. Myös keskeytysaika voi olla pidempi kuin mielivaltainen määrä, koska aikataulutus muiden toimintojen järjestelmässä.,

time.strftime(format) – ¶

Muuntaa monikko tai struct_time eli aika palauttaagmtime() tai localtime() string määritelty formatargument. Jos t ei ole säädetty, nykyinen aika, niin palautetaanlocaltime() käytetään. formaatin on oltava merkkijono., ValueError isrised jos jokin kenttä t: ssä on sallitun alueen ulkopuolella.

0 on juridinen argumentti mille tahansa kannalle ajassa tuple; jos se on normaalistilegaalinen, arvo pakotetaan oikeaan.

formaattijonoon voidaan liittää seuraavat direktiivit., He ovat shownwithout valinnaisen kentän leveys ja tarkkuus erittely, ja sijaisena toimii hänen ilmoitettu merkkiä strftime() tulos:

Huom:

1. Kun käytetään strptime() toiminto, %p direktiivi vain affectsthe lähtö tunnin kenttään, jos %I direktiivi on tapana jäsentää tuntia.,

2. välillä todella on 0 ja 61; arvo 60 on voimassa intimestamps edustaa harppaus sekuntia ja arvo 61 on supportedfor historiallisista syistä.

3. Kun käytetään strptime() – toimintoa, %U ja %W käytetään vain incalculations kun viikonpäivä ja vuosi on määritetty.

Tässä on esimerkki, päivämäärien muodon yhteensopiva määriteltyyn theRFC 2822 Internet-sähköposti-standardi., 1

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

Lisää direktiivejä voidaan tukea tietyillä alustoilla, mutta vain kuitenkin lueteltu tässä on tarkoitettu standardoitu ANSI C. nähdä koko useita-muodossa koodit tuettu foorumi, ota strftime(3)dokumentaatio.

joissakin ympäristöissä, valinnainen kenttä, leveys ja tarkkuutta erittely canimmediately seuraa alkuperäisen '%' direktiivi seuraavassa järjestyksessä;tämä on myös ei-kannettava. Kentän leveys on yleensä 2 lukuun ottamatta %j se on 3.,

time.strptime(string)¶

Parse merkkijono, joka edustaa kertaa mukaan a-muodossa. Paluu valueis struct_time kuten palautetaan gmtime() tailocaltime().

format-parametri käyttää samaa direktiiviä kuin ne, joitastrftime(); oletusarvo "%a %b %d %H:%M:%S %Y", joka vastaa theformatting palautetaan ctime(). Jos merkkijonoa ei voida jäsentää accordingto-muotoon tai jos sillä on ylimääräistä dataa jäsentämisen jälkeen, ValueError isrised., Oletusarvoja käytetään täytä puuttuvat tiedot, kun moreaccurate arvoja ei voida päätellä, ovat (1900, 1, 1, 0, 0, 0, 0, 1, -1).Sekä merkkijonon että formaatin on oltava merkkijonoja.

esimerkiksi:

Tukea %Z direktiivi perustuu sisältyvät arvot tznameja onko daylight on totta. Tämän vuoksi se on alustakohtainenyksinkertainen UTC: n ja GMT: n tunnistamiseen, jotka ovat aina tunnettuja (ja joiden katsotaan olevan ei-kesäaikoja).

vain asiakirjoissa mainitut direktiivit ovat tuettuja., Koskastrftime() toteutetaan per foorumi, se voi joskus tarjota moredirectives kuin ne on lueteltu. Mutta strptime() on riippumaton platformand näin ei kuitenkaan välttämättä tue kaikkia direktiivejä saatavilla, jotka ovat notdocumented kuin tuettu.

luokkatime.struct_time¶

tyyppi aika-arvo järjestys palautetaan gmtime(),localtime() ja strptime(). Se on objekti, jolla on nimellinen rajapinta: arvoihin pääsee indeksillä ja attribuutin nimellä., Seuraavat arvot ovat läsnä:

Huomaa, että toisin kuin C rakenne, kuukausi-arvo on erilaisia , ei.

puhelut mktime(), tm_isdst voidaan asettaa 1, kun daylightsavings aika on voimassa, ja 0, kun se ei ole. Arvo -1 osoittaa, ettätämä ei ole tiedossa, ja yleensä johtaa oikeaan tilaan täytetään.

Kun monikko kanssa virheellinen pituus on kulunut toiminnon odottaastruct_time, tai ottaa elementtejä väärä tyyppi, aTypeError nostetaan.,

time.time() → float¶

Paluu aika sekunteina, koska aikakausi kelluva pointnumber. Aikakauden erityinen päivämäärä ja Leap-sekuntien käsittely ovat alustariippuvaisia.Windowsissa ja useimmissa Unix-järjestelmissä aikakausi on 1.tammikuuta 1970,00:00 (UTC) ja karkaussekunteja ei lasketa aikasekunteihin sitten aikakauden. Tämä on yleisesti kutsutaan asUnix aikaa.Selvittää, mitä aikakausi on antanut foorumi, katsogmtime(0).,

huomaa, että vaikka aika palautuu aina kelluvana pistenumerona, kaikki järjestelmät eivät tarjoa aikaa 1 sekuntia paremmin.Vaikka tämä toiminto palauttaa yleensä ei-alenevia arvoja, se voi palauttaa pienemmän arvon kuin edellinen puhelu, jos järjestelmän kello on asetettu kahden puhelun välillä.

numero palautetaan time() voidaan muuntaa enemmän commontime-muodossa (eli vuosi, kuukausi, päivä, tunti, jne…) UTC siirtämällä segmtime() funktio tai paikallista aikaa siirtämällä selocaltime() toiminto., Molemmissa tapauksissa palautetaanstruct_time – objekti, josta kalenteripäivän osia voidaan käyttää attribuutteina.

time.thread_time() → float¶

Paluu arvo (fractional sekuntia) summa järjestelmä ja userCPU aikaan nykyisen säikeen. Siihen ei sisälly aikaa, joka kului uniunessa. Se on määritelmällisesti lankakohtainen. Lähtökohtana thereturned arvo on määrittelemätön, niin että vain ero suunnitteluun peräkkäisen puhelut samassa lanka on voimassa.,

Saatavuus: Windows -, Linux -, Unix-järjestelmien tukeminenCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

Samanlainen thread_time() mutta palaa aikaa kuin nanosekuntia.

time.time_ns() → int¶

Samanlainen time() mutta palaa aikaa kuin kokonaisluku nanosecondssince aikakausi.

time.tzset()¶

Nollaa aika muuntaminen säännöt käyttää kirjaston rutiineja. Environmentvariable TZ määrittelee, miten tämä tehdään., Se myös asettaa muuttujattzname (from TZ ympäristö muuttuja), timezone (ei-DSTseconds Länteen UTC), altzone (DST sekuntia länteen UTC) ja daylight(0 jos aikavyöhykettä ei ole kesäaika sääntöjä, tai tononzero jos on aikaa, menneisyyttä, nykyisyyttä tai tulevaisuutta, kun kesäaika timeapplies).

saatavuus: Unix.,

standardi muodossa TZ ympäristö muuttuja on (whitespaceadded selvyyden vuoksi):

std offset , end]]]

Jos osat ovat:

stdjadst

Kolme tai enemmän alphanumerics antaa aikavyöhyke lyhenteitä. Nämä esitetään ajoissa.tzname

offset

offset on muotoa: ± hh]. Tämä osoittaa, että UTC: hen saapuminen on arvoltaan paikallista aikaa., Jos sitä edeltää ’-’, aikavyöhyke on Alkumeridiaanin itäpuolella; muuten se on Länsi. Jos offset followsdst, kesäajan oletetaan olevan tunnin edellä vakioaikaa.

start, end

Osoittaa, milloin muutos ja takaisin DST. Muoto thestart-ja päättymispäivämäärät ovat seuraavat:

Jn

Julian päivä n (1 <= n <= 365). Karkauspäiviä ei lasketa, joten kaikkina vuosina helmikuu 28 on päivä 59 ja Maaliskuu 1 on päivä 60.,

n

nolla-pohjainen Julian päivä (0 <= n <= 365). Karkauspäivät lasketaan, andit on mahdollista viitata 29.helmikuuta.

Mm.n.d

time muoto on sama kuin offset paitsi että ei johtava merkki(’-’ tai ’+’) on sallittua. Oletusarvo, jos aikaa ei anneta, on 02: 00: 00.

monet Unix-järjestelmät (kuten *BSD, Linux, Solaris, ja Darwin), se on moreconvenient käyttää järjestelmän zoneinfo (tzfile(5)) tietokanta tospecify aikavyöhykkeen sääntöjä., Voit tehdä tämän, aseta TZ environmentvariable polku tarvittava aikavyöhyke datafile, suhteellinen root-ofthe järjestelmien zoneinfo’ aikavyöhyke tietokanta, joka yleensä sijaitsee osoitteessa/usr/share/zoneinfo. Esimerkiksi 'US/Eastern','Australia/Melbourne', 'Egypt' tai 'Europe/Amsterdam'.

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