tempo – tempo de acesso e conversões¶

Funções¶

time.asctime()¶

Converter em uma tupla ou struct_time representa um tempo como retornado porgmtime() ou localtime() uma cadeia de followingform: 'Sun Jun 20 23:21:05 1993'. O campo do dia é de dois caracteres longand é espaço acolchoado se o dia é um único dígito, por exemplo: 'Wed Jun 9 04:26:40 1993'.,

Se não for fornecido o t, utiliza-se o tempo actual como indicado por localtime(). A informação local não é usada por asctime().

time.pthread_getcpuclockid(thread_id)¶

Retornar a clk_id do segmento específico do CPU-relógio de tempo especificado thread_id.,

Use threading.get_ident() ou identatributo de threading.Thread objetos para obter um adequado valuefor thread_id.

disponibilidade: Unix (ver a página de manual do pthread_getcpuclockid (3) para mais informações).

time.clock_getres(clk_id)¶

Retornar a resolução (precisão) do especificado relógio clk_id., Consulte as constantes de ID do toClock para uma lista de valores aceites para o clk_ ID.

disponibilidade: Unix.

time.clock_gettime(clk_id) → float¶

Return the time of the specified clk_id. Consulte as constantes de ID do toClock para uma lista de valores aceites para o clk_ ID.

disponibilidade: Unix.

time.clock_gettime_ns(clk_id) → int n

Semelhante ao clock_gettime() mas o tempo de retorno como nanossegundos.

disponibilidade: Unix.

time.clock_settime(clk_id, time: float)¶

Set the time of the specified clock clk_id. Atualmente,CLOCK_REALTIME é o único valor aceito para clk_id.

disponibilidade: Unix.

time.clock_settime_ns(clk_id, tempo: int)¶

Semelhante ao clock_settime() mas definir a hora com nanossegundos.

disponibilidade: Unix.

time.ctime()¶

Convert a time expressed in seconds since the epoch to a string of a form:'Sun Jun 20 23:21:05 1993' representing local time. O fieldis diurno tem dois caracteres de comprimento e é acolchoado se o dia for um único algarismo, por exemplo: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(nome)¶

Get information on the specified clock as a namespace object.,Suporte de relógio nomes e as funções correspondentes ao ler seus valueare:

O resultado tem os seguintes atributos:

• ajustável: True se o relógio pode ser automaticamente alterado (ex: bya daemon NTP) ou manualmente pelo administrador do sistema, False senão

• implementação: O nome do subjacentes C) função utilizada para getthe valor do relógio. Consulte as constantes de ID do relógio para obter valores possíveis.,

• monotônica: True se o relógio não pode ir para trás,False senão

• resolução: A resolução do relógio em segundos (float)

time.gmtime()¶

Converter um tempo expresso em segundos desde a época para uma struct_time inUTC em que o sinalizador de hora de verão é sempre zero. Se a secs não for fornecida ouNone, utiliza-se o tempo actual como devolvido por time()., Os fraccionamentos de um segundo são ignorados. Veja acima para uma descrição do objetostruct_time. Ver calendar.timegm() para o inverso desta função.

time.localtime() n

Como gmtime() mas converte para a hora local. Se a secs não for fornecida ouNone, utiliza-se o tempo actual como devolvido por time(). The dstflag is set to 1 when DST applies to the Giv time.,

time.mktime(t)¶

Esta é a função inversa de localtime(). Seu argumento é o struct_time ou 9-tuple completo (Uma vez que a bandeira dst é necessária; use -1como a bandeira dst se for desconhecida) que expressa o tempo no tempo local, notUTC. Devolve um número de vírgula flutuante, para compatibilidade com time().,Se o valor de entrada não puder ser representado como um tempo válido, tantoOverflowError ou ValueError será elevado (o que depende se o valor inválido é capturado por Python ou pelas bibliotecas C subjacentes).A data mais antiga para a qual pode gerar um tempo é dependente da plataforma.

time.monotonic() → float¶

Return the value (in fractional seconds) of a monotonic clock, i.e. a clock that cannot go back. O relógio não é afetado por atualizações de relógio do sistema.,O ponto de referência do valor devolvido é indefinido, de modo que apenas a diferença entre os resultados de chamadas consecutivas é válida.

time.monotonic_ns() → int

Similar a monotonic(), mas tempo de retorno como nanosegundos.

time.perf_counter() → float ¶

Return the value (in fractional seconds) of a performance counter, i.e., aclock com a maior resolução disponível para medir uma curta duração. Ele inclui o tempo decorrido durante o sono e é de todo o sistema. O ponto de referência do valor devolvido é indefinido, de modo que apenas a diferença entre os resultados de chamadas consecutivas é válida.

time.perf_counter_ns() → int¶

Similar a perf_counter(), mas tempo de retorno como nanosegundos.

time.process_time() → float¶

Return the value (in fractional seconds) of the sum of the system and userCPU time of the current process. Não inclui o tempo decorrido durante o sono. Por definição, abrange todo o processo. O ponto de referência do valor escriturado é indefinido, de modo que apenas a diferença entre os resultados de chamadas consecutivas é válida.

time.process_time_ns() → int

Similar a process_time() mas tempo de retorno como nanosegundos.,

time.sleep(secs)¶

suspenda a execução do tópico chamador para o número de segundos indicado.O argumento pode ser um número de ponto flutuante para indicar um tempo de sono mais preciso. O tempo real de suspensão pode ser inferior ao solicitado, uma vez que qualquer sinal de combate terminará a sleep() após a execução da rotina de captura desse sinal. Além disso, o tempo de suspensão pode ser mais longo do que o solicitado por uma quantidade arbitrária devido ao agendamento de outras atividades no sistema.,

time.strftime(formato)¶

Converter em uma tupla ou struct_time representa um tempo como retornado porgmtime() ou localtime() uma cadeia de caracteres especificada pelo formatargument. Se t não for fornecido, utiliza-se o tempo actual, tal como devolvido porlocaltime(). o formato deve ser uma string., ValueError israised if any field in t is outside of the allowed range.

0 é um argumento legal para qualquer posição na tupla de tempo; se ele é normalmente ilegal o valor é forçado a um correto.

As seguintes diretivas podem ser incorporadas na cadeia de formato., Eles são shownwithout o campo opcional a largura e a especificação de precisão, e são replacedby os personagens indicados no strftime() resultado:

Observações:

1. Quando utilizado com o strptime() função, %p directiva apenas affectsthe saída de campo de hora se o %I diretiva é usada para analisar a hora.,

2. O intervalo é realmente 0 61; valor 60 é válido intimestamps representando segundos de salto e valor 61 é supportedfor razões históricas.

3. Quando utilizado com o strptime() função %U e %W são usados apenas incalculations quando o dia da semana e o ano são especificados.

Aqui está um exemplo, um formato para datas compatíveis com o especificado na norma theRFC 2822 Internet email., 1

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

Adicionais de diretivas podem ser suportados em certas plataformas, mas apenas theones listados aqui tem um significado padronizado pela ANSI C. Para ver toda a setof códigos de formato suportado em sua plataforma, consulte o strftime(3)documentação.

em algumas plataformas, uma largura de campo opcional e especificação de precisão pode imediatamente seguir a inicial '%' de uma diretiva na seguinte ordem;esta também não é portátil. A largura do campo é normalmente 2, exceto para %j onde é 3.,

time.strptime(string)¶

Parse uma string que representa um tempo de acordo com um formato. The return valueis a struct_time as returned by gmtime() orlocaltime().

O parâmetro de formato usa o mesmo directivas como aqueles usados porstrftime(); o padrão é "%a %b %d %H:%M:%S %Y" que corresponde theformatting devolvidos por ctime(). Se a cadeia não puder ser processada de acordo com o formato, ou se tiver dados excessivos após a análise, ValueError israised., Os valores por omissão usados para preencher quaisquer dados em falta quando os valores mais exactos não podem ser inferidos são (1900, 1, 1, 0, 0, 0, 0, 1, -1).Tanto string como format devem ser strings.

Por exemplo:

Suporte para o %Z directiva é com base nos valores contidos no tznamee se daylight for verdadeira. Por causa disso, é o conceito específico de plataforma para reconhecer UTC e GMT que são sempre conhecidos (e são considerados como períodos de poupança não diurnos).apenas são suportadas as directivas especificadas na documentação., Comostrftime() é implementado por plataforma, às vezes pode oferecer mais diretivas do que as listadas. Mas strptime() é independente de qualquer platformand, portanto, não suporta necessariamente todas as diretivas disponíveis, que são notdocumented como suporte.

classetime.struct_timen

O tipo do valor de tempo seqüência devolvidos por gmtime()localtime() e strptime(). It is an object with a namedtuple interface: values can be accessed by index and by attribute name., Os seguintes valores estão presentes:

Note que, ao contrário da estrutura C , o valor do mês é uma gama de, não.

In calls to mktime(), may be set to 1 when daylightsavings time is in effect, and 0 when it is not. Um valor de -1 indica que isto não é conhecido, e geralmente resultará no estado correto sendo preenchido.

Quando uma tupla com um comprimento incorreto é passado para uma função esperando umstruct_time, ou ter elementos do tipo errado, umaTypeError é gerado.,

time.time() → float¶

Return the time in seconds since the epoch as a floating pointnumber. A data específica da época e o manuseio dos segundos do Leap é dependente da plataforma.No Windows e na maioria dos sistemas Unix, A Época é 1 de janeiro de 1970,00:00:00 (UTC) e segundos bissextos não são contados para o tempo de segundos desde a época. Isto é comumente referido como asUnix time.To descubra o que é a época numa dada plataforma, vejagmtime(0).,

Note que mesmo que o tempo seja sempre devolvido como um número flutuante, nem todos os sistemas fornecem tempo com uma melhor precisão do que 1 segundo.Enquanto esta função normalmente retorna valores não-decrescentes, ela pode retornar um valor mais baixo do que uma chamada anterior se o relógio do sistema foi ajustado para trás entre as duas chamadas.

O número retornado por time() pode ser convertido em um mais commontime formato (por exemplo, ano, mês, dia, hora, etc…) em UTC passando-a paragmtime() função ou em hora local, passando-a para olocaltime() função., Em ambos os casos um objetostruct_time é devolvido, do qual os Componentes da data do calendário podem ser acessados como atributos.

time.thread_time() → float¶

Return the value (in fractional seconds) of the sum of the system and userCPU time of the current thread. Não inclui o tempo decorrido durante o sono. É específico por definição. O ponto de referência do valor thereturned é indefinido, de modo que apenas a diferença entre os resultados de chamadas consecutivas no mesmo thread é válida.,

disponibilidade: Windows, Linux, sistemas Unix que suportamCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int

Similar a thread_time() mas tempo de retorno como nanosegundos.

time.time_ns() → int n

Semelhante ao time() mas retorna a hora como um número inteiro de nanosecondssince época.

time.tzset()¶

Reset the time conversion rules used by the library rotines. The environmentvariable TZ specifies how this is done., Ele também irá definir as variáveistzname (de TZ variável de ambiente), timezone (não-DSTseconds a Oeste da UTC), altzone (DST segundos a oeste da UTC) e daylight(para 0 se este fuso horário não tem quaisquer regras de hora de verão, ou tononzero se há um tempo, passado, presente ou futuro, quando o horário de verão timeapplies).

disponibilidade: Unix.,

O formato padrão de TZ variável de ambiente é (whitespaceadded para maior clareza):

std offset , end]]]

, Onde os componentes são:

stdedst

Três ou mais indicadores alfanuméricos dando o fuso horário abreviaturas. Estas serão propostas a tempo.tzname

offset

The offset has the form: ± hh]. Isto indica o valor acrescentado da hora local para chegar a UTC., Se precedido por um” -“, o timezoneis a leste do Meridiano primo; caso contrário, é a oeste. Se não houver followsdst offset, o tempo de verão é assumido como sendo uma hora antes do tempo padrão.

indica quando mudar de e para DST. O formato de start e end datas são as seguintes:

Jn

O dia Juliano n (1 <= n <= 365). Os dias bissextos não são contados, por isso, em todos os anos, 28 de fevereiro é o dia 59 e 1 de Março é o dia 60.,

n

zero-based dia Juliano (0 <= n <= 365). Os dias bissextos são contados, e é possível referir-se a 29 de fevereiro.

Mm.n.d

time tem o mesmo formato offset exceto que nenhum sinal à esquerda(‘-‘ ou ‘+’) é permitido. O padrão, se o tempo não for dado, é 02: 00: 00.

em muitos sistemas Unix (incluindo * BSD, Linux, Solaris e Darwin), é moreconvenient para usar o banco de dados zoneinfo (tzfile(5)) do sistema tospecificar as regras do fuso-horário., Para isso, defina o TZ ambientvariável para o caminho do datafile de fuso-horário necessário, em relação à raiz da base de dados de fuso-horário dos sistemas ‘zoneinfo’, geralmente localizada em/usr/share/zoneinfo. Por exemplo, 'US/Eastern''Australia/Melbourne' 'Egypt' ou 'Europe/Amsterdam'.

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