– Zeit – Zeit-Zugriff und Umbauten¶

Funktionen¶

time.asctime()¶

In einem Tupel oder struct_time repräsentiert eine Zeit zurückgegeben durchgmtime() oder localtime() einen string der followingform: 'Sun Jun 20 23:21:05 1993'. Das Feld Tag ist zwei Zeichen langund ist Leerzeichen aufgefüllt, wenn der Tag eine einzelne Ziffer ist, zB: 'Wed Jun 9 04:26:40 1993'.,

Wenn t nicht angegeben ist, wird die von localtime()zurückgegebene aktuelle Uhrzeit verwendet. Gebietsschema-Informationen nicht verwendet werden mit asctime().

time.pthread_getcpuclockid(thread_id)¶

Gibt die clk_id der thread-spezifischen CPU-Zeituhr für die angegebene thread_id zurück.,

Verwenden Sie threading.get_ident() oder das ident – Attribut von threading.Thread – Objekten, um einen geeigneten Wert zu erhaltenfür thread_id.

Verfügbarkeit: Unix (weitere Informationen finden Sie auf der Manpage für pthread_getcpuclockid(3)).

time.clock_getres(clk_id)¶

bringen Sie die Auflösung (Genauigkeit) der angegebene Uhr clk_id., Eine Liste der akzeptierten Werte für clk_id finden Sie unter Block-ID-Konstanten.

Verfügbarkeit: Unix.

time.clock_gettime(clk_id) → float¶

Geben Sie die Zeit an der Uhr angegeben clk_id. Eine Liste der akzeptierten Werte für clk_id finden Sie unter Block-ID-Konstanten.

Verfügbarkeit: Unix.

time.clock_gettime_ns(clk_id) → int¶

Ähnlich wie clock_gettime() doch die Zeit zurück, als die Nanosekunden.

Verfügbarkeit: Unix.

time.clock_settime(clk_id, time: float)¶

Legen Sie die Zeit an der Uhr angegeben clk_id. Derzeit istCLOCK_REALTIME der einzige akzeptierte Wert für clk_id.

Verfügbarkeit: Unix.

time.clock_settime_ns(clk_id, Zeit: int)¶

Ähnlich wie clock_settime() aber mal mit Nanosekunden.

Verfügbarkeit: Unix.

time.ctime()¶

Konvertieren Sie eine Zeit, die seit der Epoche in Sekunden ausgedrückt wird, in eine Zeichenfolge eines Formulars:'Sun Jun 20 23:21:05 1993' repräsentiert die Ortszeit. Das Tagesfeld ist zwei Zeichen lang und wird mit Leerzeichen aufgefüllt,wenn der Tag eine einzelne Ziffer ist, z. B.: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(name)¶

Informationen zur angegebenen Uhr als Namespace-Objekt abrufen.,Unterstützte Taktnamen und die entsprechenden Funktionen zum Lesen ihrer Werte:

Das Ergebnis hat folgende Attribute:

• einstellbar: True wenn die Uhr automatisch (z. B. bya NTP-Daemon) oder manuell vom Systemadministrator geändert werden kann, False andernfalls

• Implementierung: Der Name der zugrunde liegenden C-Funktion, mit der getthe uhr wert. Mögliche Werte finden Sie unter Uhr-ID-Konstanten.,

• monoton: True wenn die Uhr nicht rückwärts laufen kann,False ansonsten

• Auflösung: Die Auflösung der Uhr in Sekunden (float)

time.gmtime()¶

Wandeln Sie eine in Sekunden seit der Epoche ausgedrückte Zeit in eine struct_time inUTC um, in der das dst-Flag immer Null ist. Wenn secs nicht angegeben ist oderNone, wird die aktuelle von time() zurückgegebene Zeit verwendet., Sekundenbruchteile werden ignoriert. Eine Beschreibung desstruct_time – Objekts finden Sie oben. Siehe calendar.timegm() für die Umkehrung dieser Funktion.

time.localtime()¶

Wie gmtime() aber in die lokale Zeit konvertiert. Wenn secs nicht angegeben ist oderNone, wird die aktuelle von time() zurückgegebene Zeit verwendet. Der dstflag wird auf 1 gesetzt, wenn DST auf die angegebene Zeit zutrifft.,

time.mktime(t)¶

Dies ist die inverse Funktion von localtime(). Sein Argument ist dasstruct_time oder das vollständige 9-Tupel (da das dst-Flag benötigt wird; Verwenden Sie -1als dst-Flag, wenn es unbekannt ist), das die Uhrzeit in der Ortszeit ausdrückt, nichtutc. Es gibt eine Gleitkommazahl, für die Kompatibilität mit time().,Wenn der Eingabewert nicht als gültige Zeit dargestellt werden kann, wird entwederOverflowError oder ValueError ausgelöst (was davon abhängt, ob der ungültige Wert von Python oder den zugrunde liegenden C-Bibliotheken abgefangen wird).Das früheste Datum, für das eine Zeit generiert werden kann, ist plattformabhängig.

time.monotonic() → float¶

Gibt den Wert (in Sekundenbruchteilen) einer monotonen Uhr zurück, dh eine Uhrdas kann nicht rückwärts gehen. Die Uhr ist nicht von Systemtaktupdates betroffen.,Der Referenzpunkt des zurückgegebenen Werts ist undefiniert, so dass nur diedifferenz zwischen den Ergebnissen aufeinanderfolgender Aufrufe ist gültig.

time.monotonic_ns() → int¶

Ähnlich wie monotonic(), aber Zeit zurück, als die Nanosekunden.

time.perf_counter() → float¶

Gibt den Wert (in Sekundenbruchteilen) eines Leistungszählers zurück, d.h., aclock mit der höchsten verfügbaren Auflösung, um eine kurze Dauer zu messen. Itdoes umfassen Zeit während des Schlafes verstrichen und ist systemweit. Der Referenzpunkt des zurückgegebenen Werts ist undefiniert, sodass nur der Unterschied zwischen den Ergebnissen aufeinanderfolgender Aufrufe gültig ist.

time.perf_counter_ns() → int¶

Ähnlich wie perf_counter(), aber Zeit zurück, als die Nanosekunden.

time.process_time() → float¶

Gibt den Wert (in Sekundenbruchteilen) der Summe der System-und userCPU-Zeit des aktuellen Prozesses zurück. Es enthält keine Zeit verstrichen duringsleep. Es ist per Definition prozessweit. Der Bezugspunkt des umgedrehten Werts ist undefiniert, sodass nur die Differenz zwischen den Ergebnissen aufeinanderfolgender Aufrufe gültig ist.

time.process_time_ns() → int¶

Ähnlich wie process_time() doch die Zeit zurück, als die Nanosekunden.,

time.sleep(secs)¶

Unterbrechen Sie die Ausführung des aufrufenden Threads für die angegebene Anzahl von Sekunden.Das Argument kann eine Gleitkommazahl sein, um eine genauere Schlafzeit anzuzeigen. Die tatsächliche Aussetzungszeit kann geringer sein als die angeforderte, da anycaught signal die sleep() nach Ausführung der Fangroutine von thatsignal beendet. Außerdem kann die Aussetzungszeit aufgrund der Planung anderer Aktivitäten im System um einen beliebigen Betrag länger sein als erforderlich.,

time.strftime(format)¶

Konvertieren Sie ein Tupel oder struct_time, das eine Zeit darstellt, die vongmtime() oder localtime() in eine Zeichenfolge zurückgegeben wird, wie im formatargument angegeben. Wenn t nicht angegeben wird, wird die vonlocaltime() zurückgegebene aktuelle Uhrzeit verwendet. format muss eine Zeichenfolge sein., ValueError improvisiert, wenn ein Feld in t außerhalb des zulässigen Bereichs liegt.

0 ist ein legales Argument für jede Position im Zeittupel; wenn es normal istillegal Der Wert wird zu einem korrekten gezwungen.

Die folgenden Direktiven können in die Formatzeichenfolge eingebettet werden., Sie werden ohne die optionale Feldbreite und Präzisionsspezifikation angezeigt und durch die angegebenen Zeichen in der strftime() ersetzt Ergebnis:

Hinweise:

1. Bei Verwendung mit der strptime() – Funktion wirkt sich die %p – Direktive nur dann auf das Ausgabestundenfeld aus, wenn die %I Direktive wird verwendet, um die Stunde zu analysieren.,

2. Der Bereich ist wirklich 0 bis 61; value 60 ist gültige Zeitstempel, die Schaltsekunden darstellen, und value 61 wird aus historischen Gründen unterstützt.

3. Bei Verwendung mit der Funktion strptime() werden %U und %W nur Inberechnungen verwendet, wenn der Wochentag und das Jahr angegeben sind.

Hier ist ein Beispiel, ein Format für Daten kompatibel mit dem in DERFC 2822 Internet-E-Mail-Standard angegeben., 1

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

Auf bestimmten Plattformen können zusätzliche Direktiven unterstützt werden, aber nur die hier aufgeführten Direktiven haben eine von ANSI C standardisierte Bedeutung.

Auf einigen Plattformen kann eine optionale Feldbreite und Präzisionsspezifikation der anfänglichen '%' einer Direktive in der folgenden Reihenfolge folgen;dies ist auch nicht portabel. Die Feldbreite beträgt normalerweise 2 mit Ausnahme von %j wherees ist 3.,

time.strptime(string)¶

Analysieren Sie eine Zeichenfolge, die eine Zeit gemäß einem Format darstellt. Der Rückgabewertist ein struct_time wie von gmtime() oderlocaltime()zurückgegeben.

Der Parameter format verwendet die gleichen Direktiven wie die vonstrftime(); standardmäßig "%a %b %d %H:%M:%S %Y", was mit der von ctime()zurückgegebenen Formatierung übereinstimmt. Wenn die Zeichenfolge nicht analysiert werden kann accordingto format, oder wenn Sie überschüssige Daten nach dem Parsen ValueError israised., Die Standardwerte, die zum Ausfüllen fehlender Daten verwendet werden, wenn keine weiteren Accurate-Werte abgeleitet werden können, sind (1900, 1, 1, 0, 0, 0, 0, 1, -1).Sowohl string als auch Format müssen Strings sein.

Zum Beispiel:

Die Unterstützung der %Z – Direktive basiert auf den Werten in tznameund ob daylight wahr ist. Aus diesem Grund ist es plattformspezifischausdruck für die Erkennung von UTC und GMT, die immer bekannt sind (und als Nicht-Sommerzeit-Zeitzonen gelten).

Es werden nur die in der Dokumentation angegebenen Direktiven unterstützt., Dastrftime() pro Plattform implementiert ist, kann es manchmal mehr bietenrichtlinien als die aufgeführten. Aber strptime() ist unabhängig von jeder Plattform und unterstützt daher nicht unbedingt alle verfügbaren Direktiven, die nicht als unterstützt deklariert sind.

classtime.struct_time¶

Der Typ des Zeit-Wert-Sequenz zurückgegeben gmtime(),localtime() und strptime(). Es ist ein Objekt mit einer Namedtuple-Schnittstelle: Auf Werte kann nach Index und Attributname zugegriffen werden., Thefollowing Werte vorhanden sind:

Beachten Sie, dass im Gegensatz zu der C-Struktur, die Monat Wert ist eine Reihe , nicht.

Bei Aufrufen von mktime() kann tm_isdst auf 1 gesetzt werden, wenn die Zeit für Tageslichteinsparungen wirksam ist, und 0, wenn dies nicht der Fall ist. Ein Wert von -1 gibt das anDies ist nicht bekannt und führt normalerweise dazu, dass der richtige Status ausgefüllt wird.

Wenn ein Tupel mit einer falschen Länge an eine Funktion übergeben wird, die einestruct_time erwartet oder Elemente des falschen Typs enthält, wird eineTypeError ausgelöst.,

time.time() → float¶

Geben Sie die Zeit in Sekunden seit der Epoche als schwimmende punktnummer. Das spezifische Datum der Epoche und die Handhabung vonleap Sekunden ist plattformabhängig.Unter Windows und den meisten Unix-Systemen ist die Epoche Januar 1, 1970,00:00: 00 (UTC) und Schaltsekunden werden nicht in Richtung der Zeit gezähltein Sekunden seit der Epoche. Dies wird allgemein als asUnix bezeichnet time.To finden Sie heraus, was die Epoche auf einer bestimmten Plattform ist, schauen Sie sichgmtime(0)an.,

Beachten Sie, dass, obwohl die Zeit immer als Gleitkommazahl zurückgegeben wird, nicht alle Systeme Zeit mit einer besseren Genauigkeit als 1 Sekunde bereitstellen.Während diese Funktion normalerweise nicht abnehmende Werte zurückgibt, kann sie einen niedrigeren Wert als bei einem vorherigen Aufruf zurückgeben, wenn die Systemuhr zwischen den beiden Aufrufen zurückgesetzt wurde.

Die von time() zurückgegebene Zahl kann in UTC in ein Commontime-Format (dh Jahr, Monat, Tag, Stunde usw.) konvertiert werden, indem sie an die Funktiongmtime() übergeben wird, oder in Ortszeit, indem sie an die Funktionlocaltime() übergeben wird., In beiden Fällen wird einstruct_time Objekt zurückgegeben, von dem aus auf die Komponenten des Kalenderdatums als Attribute zugegriffen werden kann.

time.thread_time() → float¶

Gibt den Wert (in Sekundenbruchteilen) der Summe der System-und userCPU-Zeit des aktuellen Threads zurück. Es enthält keine Zeit verstrichen duringsleep. Es ist per Definition thread-spezifisch. Der Bezugspunkt des umgedrehten Werts ist undefiniert, so dass nur der Unterschied zwischen den resultsof aufeinanderfolgenden Aufrufen im selben Thread gültig ist.,

Verfügbarkeit: Windows, Linux, Unix-Systeme unterstützenCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

Ähnlich wie thread_time() doch die Zeit zurück, als die Nanosekunden.

time.time_ns() → int¶

Ähnlich wie time() gibt jedoch die Zeit als ganzzahlige Anzahl von Nanosekunden zurückseit der Epoche.

time.tzset()¶

Setzen Sie die von den Bibliotheksroutinen verwendeten Zeitkonvertierungsregeln zurück. Die umgebungsvariable TZ gibt an, wie dies gemacht wird., Es werden auch die Variablentzname (aus der Umgebungsvariablen TZ), timezone (nicht-DSTseconds westlich von UTC), altzone (DST Sekunden westlich von UTC) und daylight(auf 0, wenn diese Zeitzone hat keine sommerzeit regeln, oder tononzero wenn es eine zeit, vergangenheit, gegenwart oder zukunft, wenn sommerzeit timeapplies).

Verfügbarkeit: Unix.,

Das Standardformat der Umgebungsvariablen TZ ist (zur Verdeutlichung whitespeadded):

std offset , end]]]

Wobei die Komponenten sind:

stdunddst

Drei oder mehr alphanumerische Zeichen, die die Zeitzonenabkürzungen angeben. Diese werden in die Zeit umgesetzt.tzname

offset

Der offset hat die form: ± hh]. Dies gibt die Wertschöpfung der Ortszeit an, um bei UTC anzukommen., Wenn ein ‘ – ‚ vorangestellt ist, ist die Zeitzoneist östlich des Hauptmeridians; andernfalls ist es Westen. Folgt kein Versatz, wird von einer Stunde Sommerzeit ausgegangen.

start, end

Gibt an, wann von DST zu und zurück gewechselt werden soll. Das format thestart-und Enddatum sind die folgenden:

Jn

Der Julianische Tag n (1 <= n <= 365). Schalttage werden nicht gezählt, also inalle Jahre Februar 28 ist Tag 59 und März 1 ist Tag 60.,

n

Der nullbasierte julianische Tag (0 <= n <= 365). Schalttage werden gezählt, undEs ist möglich, sich auf den 29.

Mm.n.d

time hat das gleiche Format wie offset mit der Ausnahme, dass kein Vorzeichen(‚-‚ oder ‚+‘) zulässig ist. Die Standardeinstellung, wenn die Zeit nicht angegeben ist, ist 02: 00: 00.

Auf vielen Unix-Systemen (einschließlich *BSD, Linux, Solaris und Darwin) ist es sinnvoller, die Systemdatenbank zoneinfo (tzfile(5)) zu verwendenspezifizieren Sie die Zeitzonenregeln., Setzen Sie dazu die Umgebungsvariable TZ auf den Pfad der erforderlichen Zeitzonendatendatendatei relativ zum Stamm der Systemdatenbank ‚zoneinfo‘, normalerweise unter/usr/share/zoneinfo. Zum Beispiel 'US/Eastern','Australia/Melbourne', 'Egypt' oder 'Europe/Amsterdam'.

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