Funzioni¶

time.asctime()¶

Convertire una tupla o struct_time rappresenta un momento come restituito dagmtime() o localtime() per una stringa di followingform: 'Sun Jun 20 23:21:05 1993'. Il campo giorno è lungo due caratteri ed è riempito di spazio se il giorno è una singola cifra, ad esempio: 'Wed Jun 9 04:26:40 1993'.,

Se t non viene fornito, viene utilizzata l’ora corrente restituita dalocaltime(). Le informazioni locali non vengono utilizzate da asctime().

Nota

A differenza della funzione C con lo stesso nome,asctime() non aggiunge una nuova riga di comando.

time.pthread_getcpuclockid(thread_id)¶

Restituisce il clk_id dell’orologio di tempo della CPU specifico per il thread per il thread_id specificato.,

Usa threading.get_ident()o l’attributo ident degli oggetti threading.Thread per ottenere un valore adatto per thread_id.

Warning

Il passaggio di un thread_id non valido o scaduto può comportare un comportamento non definito, ad esempio un errore di segmentazione.

Disponibilità: Unix (vedere la pagina man per pthread_getcpuclockid (3) per ulteriori informazioni).

Nuovo nella versione 3.7.

time.clock_getres(clk_id)¶

Restituisce la risoluzione (precisione) dell’orologio clk_id specificato., Fare riferimento alle costanti ID di blocco per un elenco di valori accettati per clk_id.

Disponibilità: Unix.

Nuovo nella versione 3.3.

time.clock_gettime(clk_id) → float¶

Restituisce l’ora dell’orologio clk_id specificato. Fare riferimento alle costanti ID di blocco per un elenco di valori accettati per clk_id.

Disponibilità: Unix.

Nuovo nella versione 3.3.

time.clock_gettime_ns(clk_id) → int¶

Simile aclock_gettime() ma restituisce il tempo come nanosecondi.

Disponibilità: Unix.

Nuovo nella versione 3.7.,

time.clock_settime(clk_id, time: float)¶

Imposta l’ora dell’orologio clk_id specificato. Attualmente,CLOCK_REALTIME è l’unico valore accettato per clk_id.

Disponibilità: Unix.

Nuovo nella versione 3.3.

time.clock_settime_ns(clk_id, time: int)¶

Simile aclock_settime() ma imposta il tempo con nanosecondi.

Disponibilità: Unix.

Nuovo nella versione 3.7.,

time.ctime()¶

Converti un tempo espresso in secondi dall’epoca in una stringa di un modulo: 'Sun Jun 20 23:21:05 1993' che rappresenta l’ora locale. Il campo day è lungo due caratteri ed è riempito di spazio se il giorno è una singola cifra, ad esempio: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(nome)¶

Ottieni informazioni sull’orologio specificato come oggetto namespace.,Supportato orologio nomi e le funzioni corrispondenti a leggere i loro valueare:

Il risultato ha i seguenti attributi:

  • regolabile: True se l’orologio può essere cambiato automaticamente (es. da demone NTP) o manualmente dall’amministratore di sistema, False altrimenti

  • di attuazione: Il nome del sottostante C funzione utilizzata per getthe orologio di valore. Fare riferimento alle Costanti ID orologio per i possibili valori.,

  • monotona: True se l’orologio non può tornare indietro,False altrimenti

  • risoluzione: La risoluzione dell’orologio, in pochi secondi (float)

novità nella versione 3.3.

time.gmtime()¶

Converte un tempo espresso in secondi dall’epoca in un struct_time inUTC in cui il flag dst è sempre zero. Se secs non viene fornito oNone, viene utilizzata l’ora corrente restituita da time()., Le frazioni di secondo vengono ignorate. Vedi sopra per una descrizione dell’oggettostruct_time. Vedere calendar.timegm() per l’inverso di questa funzione.

time.localtime()¶

Comegmtime() ma converte in ora locale. Se secs non viene fornito oNone, viene utilizzata l’ora corrente restituita da time(). Il dstflag è impostato su 1 quando l’ora legale si applica all’ora specificata.,

time.mktime(t)¶

Questa è la funzione inversa dilocaltime(). Il suo argomento è struct_timeo full 9-tuple (poiché è necessario il flag dst; usa-1 come flag dst se è sconosciuto) che esprime l’ora in ora locale, notUTC. Restituisce un numero in virgola mobile, per compatibilità contime().,Se il valore di input non può essere rappresentato come un tempo valido, verrà generatoOverflowError o ValueError (che dipende se il valore non valido viene rilevato da Python o dalle librerie C sottostanti).La prima data per la quale può generare un tempo dipende dalla piattaforma.

time.monotonic() → float¶

Restituisce il valore (in secondi frazionari) di un orologio monotonico, cioè un orologio che non può tornare indietro. L’orologio non è influenzato dagli aggiornamenti dell’orologio di sistema.,Il punto di riferimento del valore restituito non è definito, in modo che solo la differenza tra i risultati delle chiamate consecutive sia valida.

Nuovo nella versione 3.3.

Cambiato nella versione 3.5: La funzione è ora sempre disponibile e sempre a livello di sistema.

time.monotonic_ns() → int¶

Simile amonotonic(), ma restituisce il tempo come nanosecondi.

Nuovo nella versione 3.7.

time.perf_counter() → float¶

Restituisce il valore (in secondi frazionari) di un contatore di prestazioni, ovvero, aclock con la più alta risoluzione disponibile per misurare una breve durata. Itdoes includono tempo trascorso durante il sonno ed è a livello di sistema. Il punto di riferimento del valore restituito non è definito, in modo che solo la differenza tra i risultati delle chiamate consecutive sia valida.

Nuovo nella versione 3.3.

time.perf_counter_ns() → int¶

Simile aperf_counter(), ma restituisce il tempo come nanosecondi.

Nuovo nella versione 3.7.,

time.process_time() → float¶

Restituisce il valore (in secondi frazionari) della somma del tempo del sistema e dell’userCPU del processo corrente. Non include il tempo trascorso durantedormire. È a livello di processo per definizione. Il punto di riferimento del valore restituito non è definito, in modo che sia valida solo la differenza tra i risultati delle chiamate consecutive.

Nuovo nella versione 3.3.

time.process_time_ns() → int¶

Simile aprocess_time() ma restituisce il tempo come nanosecondi.,

Nuovo nella versione 3.7.

time.sleep(secs)¶

Sospendi l’esecuzione del thread chiamante per un determinato numero di secondi.L’argomento può essere un numero in virgola mobile per indicare un tempo di sonno più preciso. Il tempo di sospensione effettivo potrebbe essere inferiore a quello richiesto perché anycaught signal terminerà sleep() dopo l’esecuzione della routine di cattura di thatsignal. Inoltre, il tempo di sospensione potrebbe essere più lungo di quello richiesto da una quantità arbitraria a causa della pianificazione di altre attività nel sistema.,

Cambiato nella versione 3.5: La funzione ora dorme almeno secondi anche se il sonno viene interrotto da un segnale, tranne se il gestore del segnale solleva un’eccezione(seePEP 475 per la logica).

time.strftime(formato)¶

Convertire una tupla o struct_time rappresenta un momento come restituito dagmtime() o localtime() per una stringa, come specificato dal formatargument. Se t non viene fornito, viene utilizzata l’ora corrente restituita dalocaltime(). il formato deve essere una stringa., ValueError israised se qualsiasi campo in t è al di fuori dell’intervallo consentito.

0 è un argomento legale per qualsiasi posizione nella tupla temporale; se è normalmenteillegal il valore è costretto a uno corretto.

Le seguenti direttive possono essere incorporate nella stringa di formato., Sono shownwithout il campo opzionale larghezza e precisione specifica e replacedby indicato caratteri di un strftime() risultato:

Note:

  1. Quando usato con i tag strptime() la funzione %p direttiva solo affectsthe uscita ora campo se il %I direttiva viene utilizzato per analizzare l’ora.,

  2. L’intervallo è davvero 0 a 61; il valore 60 è valido intimestamps che rappresentano i secondi bisestili e il valore 61 è supportato per ragioni storiche.

  3. Quando viene utilizzato con la funzionestrptime(),%Ue%W vengono utilizzati solo nei calcoli quando vengono specificati il giorno della settimana e l’anno.

Ecco un esempio, un formato per le date compatibile con quello specificato nello standard di posta elettronica Internet CFC 2822., 1

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

Le direttive aggiuntive possono essere supportate su determinate piattaforme, ma solo quelle elencate qui hanno un significato standardizzato da ANSI C. Per vedere il set completo di codici di formato supportati sulla piattaforma, consultare la documentazione strftime(3).

Su alcune piattaforme, una specifica opzionale di larghezza di campo e precisione può seguire immediatamente l’iniziale'%' di una direttiva nel seguente ordine;anche questo non è portabile. La larghezza del campo è normalmente 2 tranne che per %j dove è 3.,

time.strptime(string)¶

Analizza una stringa che rappresenta un tempo secondo un formato. Il valore restituito è unstruct_time come restituito dagmtime() olocaltime().

Il parametro format utilizza le stesse direttive di quelle utilizzate dastrftime(); il valore predefinito è "%a %b %d %H:%M:%S %Y" che corrisponde alla formattazione restituita da ctime(). Se la stringa non può essere analizzata in base al formato, o se ha dati in eccesso dopo l’analisi,ValueError israised., I valori predefiniti utilizzati per compilare i dati mancanti quando non è possibile dedurre valori più precisi sono (1900, 1, 1, 0, 0, 0, 0, 1, -1).Sia la stringa che il formato devono essere stringhe.

Ad esempio:

Il supporto per la direttiva %Z si basa sui valori contenuti in tznamee se daylight è true. Per questo motivo, è specifico per la piattaforma, ad eccezione del riconoscimento di UTC e GMT che sono sempre noti (e sono considerati fusi orari non diurni).

Sono supportate solo le direttive specificate nella documentazione., Poichéstrftime() è implementato per piattaforma, a volte può offrire piùdirettive rispetto a quelle elencate. Ma strptime() è indipendente da qualsiasi piattaforma e quindi non supporta necessariamente tutte le direttive disponibili che non sono documentate come supportate.

classe time.struct_time

Il tipo di tempo sequenza di valori restituiti da gmtime()localtime() e strptime(). È un oggetto con un’interfaccia namedtuple: i valori sono accessibili per indice e per nome di attributo., Sono presenti i seguenti valori:

Si noti che, a differenza della struttura C , il valore del mese è un intervallo di, not.

Nelle chiamate amktime(),tm_isdst può essere impostato su 1 quando il tempo daylightsavings è attivo e 0 quando non lo è. Un valore di -1 indica chequesto non è noto e di solito comporterà la compilazione dello stato corretto.

Quando una tupla con una lunghezza errata viene passata a una funzione che si aspetta unstruct_time, o che ha elementi del tipo sbagliato, viene generato unTypeError.,

time.time() → float¶

Restituisce il tempo in secondi dall’epoca come numero di punti fluttuante. La data specifica dell’epoca e la gestione dei secondi di apertura dipendono dalla piattaforma.Su Windows e la maggior parte dei sistemi Unix, l’epoca è il 1 gennaio 1970,00: 00: 00 (UTC) e i secondi bisestili non vengono contati verso il timein secondi dall’epoca. Questo è comunemente chiamato asUnix time.To scopri qual è l’epoca su una determinata piattaforma, guardagmtime(0).,

Si noti che anche se il tempo viene sempre restituito come numero di punti fluttuante, non tutti i sistemi forniscono il tempo con una precisione migliore di 1 secondo.Mentre questa funzione restituisce normalmente valori non decrescenti, può restituire un valore inferiore rispetto a una chiamata precedente se l’orologio di sistema è stato impostato tra le due chiamate.

Il numero restituito da time() può essere convertito in un formato più comune (cioè anno, mese, giorno, ora, ecc UTC) in UTC passandolo alla funzionegmtime() o in ora locale passandolo alla funzionelocaltime()., In entrambi i casi viene restituito un oggettostruct_time, dal quale è possibile accedere ai componenti della data di calendario come attributi.

time.thread_time() → float¶

Restituisce il valore (in secondi frazionari) della somma del tempo del sistema e dell’userCPU del thread corrente. Non include il tempo trascorso durantedormire. È specifico del thread per definizione. Il punto di riferimento del valore restituito non è definito, in modo che sia valida solo la differenza tra i risultati delle chiamate consecutive nello stesso thread.,

Disponibilità: sistemi Windows, Linux, Unix che supportanoCLOCK_THREAD_CPUTIME_ID.

Nuovo nella versione 3.7.

time.thread_time_ns() → int¶

Simile athread_time() ma restituisce il tempo come nanosecondi.

Nuovo nella versione 3.7.

time.time_ns() → int¶

Simile atime() ma restituisce il tempo come numero intero di nanosecondi dall’epoca.

Nuovo nella versione 3.7.,

time.tzset()¶

Reimposta le regole di conversione del tempo utilizzate dalle routine della libreria. environmentvariable TZ specifica come questo viene fatto., Sarà, inoltre, impostare le variabilitzname (da TZ variabile di ambiente), timezone (non DSTseconds Ovest dell’UTC, altzone (DST secondi a ovest di UTC) e daylight(a 0 se il fuso orario non ha alcun regole dell’ora legale, o tononzero se c’è un tempo, passato, presente o futuro, quando l’ora legale timeapplies).

Disponibilità: Unix.,

Nota

anche se in molti casi la modifica del TZ variabile di ambiente mayaffect l’output di funzioni come localtime() senza chiamaretzset(), questo comportamento non dovrebbe essere invocata.

La variabile di ambienteTZ non deve contenere spazi bianchi.,

Il formato standard del TZ variabile di ambiente (whitespaceadded per chiarezza):

std offset , end]]]

in Cui i componenti sono:

std e dst

Tre o più caratteri alfanumerici dare il fuso orario di abbreviazioni. Questi sarannopropagati nel tempo.tzname

offset

L’offset ha la forma:± hh]. Questo indica il valore aggiunto l’ora locale per arrivare a UTC., Se preceduto da un‘ -‘, il fuso orario è ad est del Meridiano Primo; altrimenti, è ad ovest. Se non segue alcun offset, si presume che l’ora legale sia un’ora prima dell’ora standard.

start, end

Indica quando passare all’ora legale e viceversa. Il formato delle date di inizio e fine è uno dei seguenti:

Jn

Il giorno giuliano n (1 <= n <= 365). I giorni bisestili non sono contati, quindi intutti gli anni il 28 febbraio è il giorno 59 e il 1 marzo è il giorno 60.,

n

Il giorno giuliano a base zero (0<= n< = 365). I giorni bisestili sono contati, eè possibile fare riferimento al 29 febbraio.

Mm.n.d

timeha lo stesso formato dioffset tranne per il fatto che non è consentito alcun segno iniziale(‘-‘ o‘+’). Il valore predefinito, se il tempo non è dato, è 02: 00: 00.

Su molti sistemi Unix (inclusi *BSD, Linux, Solaris e Darwin), è più conveniente utilizzare il database zoneinfo (tzfile(5)) del sistema per specificare le regole del fuso orario., Per fare ciò, impostare l’ambiente TZ variabile sul percorso del file di dati del fuso orario richiesto, relativo alla radice del database del fuso orario dei sistemi ‘zoneinfo’, di solito situato in/usr/share/zoneinfo. Ad esempio,'US/Eastern','Australia/Melbourne','Egypt' o'Europe/Amsterdam'.

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