tiempo de Tiempo de acceso y las conversiones¶

Funciones¶

time.asctime()¶

Convertir una tupla o struct_time representa un momento como el que devuelvegmtime() o localtime() para una cadena de la followingform: 'Sun Jun 20 23:21:05 1993'. El campo día tiene dos caracteres y se rellena con espacio si el día es de un solo dígito, por ejemplo: 'Wed Jun 9 04:26:40 1993'.,

si no se proporciona t, se utiliza la hora actual devuelta por localtime(). La información de configuración regional no es utilizada por asctime().

time.pthread_getcpuclockid(thread_id)¶

devuelve el clk_id del reloj de tiempo de CPU específico del hilo para el thread_id especificado.,

Usethreading.get_ident()o el atributoidentde los objetosthreading.Thread para obtener un valor adecuado para thread_id.

disponibilidad: Unix (vea la página man para pthread_getcpuclockid (3) para más información).

time.clock_getres(clk_id)¶

Volver a la resolución (precisión) de la especificada reloj clk_id., Refiérase a las constantes de ID de tocock para obtener una lista de valores aceptados para clk_id.

disponibilidad: Unix.

time.clock_gettime(clk_id) → float¶

Volver a la hora del reloj clk_id. Refiérase a las constantes de ID de tocock para obtener una lista de valores aceptados para clk_id.

disponibilidad: Unix.

time.clock_gettime_ns(clk_id) → int¶

Similar a clock_gettime() pero el tiempo de retorno como de los nanosegundos.

disponibilidad: Unix.

time.clock_settime(clk_id, tiempo: float)¶

Ajustar la hora del reloj clk_id. Actualmente,CLOCK_REALTIME es el único valor aceptado para clk_id.

disponibilidad: Unix.

time.clock_settime_ns(clk_id, time: int)¶

Similar a clock_settime() pero establece el tiempo con nanosegundos.

disponibilidad: Unix.

time.ctime()¶

Convierte un tiempo expresado en segundos desde la época en una cadena de una forma:'Sun Jun 20 23:21:05 1993' representando la hora local. El campo día tiene dos caracteres de largo y se rellena con espacio si el día es de un solo dígito, por ejemplo: 'Wed Jun 9 04:26:40 1993'.

time.get_clock_info(name)¶

obtener información sobre el reloj especificado como un objeto de espacio de nombres.,Los nombres de reloj soportados y las funciones correspondientes para leer su valor son:

el resultado tiene los siguientes atributos:

• ajustable: True si el reloj se puede cambiar automáticamente (por ejemplo, por un demonio NTP) o manualmente por el administrador del sistema, False de lo contrario

• implementación: el nombre de la función C subyacente utilizada para obtener el valor del reloj. Consulte las constantes de ID de reloj para ver los posibles valores.,

• monotónico: True si el reloj no puede ir hacia atrás,False de lo contrario

• resolución: la resolución del reloj en segundos (float)

time.gmtime()¶

Convertir un tiempo expresado en segundos desde la época a un struct_time inUTC en el que el horario de verano bandera es siempre cero. Si no se proporciona secs oNone, se utiliza la hora actual devuelta por time()., Las fracciones de segundo se ignoran. Vea arriba para una descripción del objetostruct_time. Véase calendar.timegm() para la inversa de thisfunction.

time.localtime()¶

Como gmtime() pero convierte a la hora local. Si no se proporciona secs oNone, se utiliza la hora actual devuelta por time(). El dstflag se establece en 1 cuando DST se aplica a la hora dada.,

time.mktime(t)¶

Esta es la función inversa de localtime(). Su argumento es elstruct_time o 9-tupla completa (ya que se necesita la bandera dst; use -1como la bandera dst si es desconocida) que expresa la hora en hora local, notUTC. Devuelve un número de coma flotante, para compatibilidad con time().,Si el valor de entrada no se puede representar como un tiempo válido, se elevaráOverflowError o ValueError (lo que depende de si el valor no válido es capturado por Python o las bibliotecas C subyacentes).La fecha más temprana para la que puede generar un tiempo depende de la plataforma.

time.monotonic() → float¶

devuelve el valor (en segundos fraccionados) de un reloj monótono, es decir, un reloj que no puede retroceder. El reloj no se ve afectado por las actualizaciones del reloj del sistema.,El punto de referencia del valor devuelto no está definido, por lo que solo la diferencia entre los resultados de llamadas consecutivas es válida.

time.monotonic_ns() → int¶

Similar a monotonic(), pero el tiempo de retorno como de los nanosegundos.

time.perf_counter() → float¶

devuelve el valor (en fracciones de segundos) de un contador de rendimiento, es decir,, aclock con la resolución más alta disponible para medir una duración corta. Incluye el tiempo transcurrido durante el sueño y abarca todo el sistema. El punto de referencia del valor devuelto es indefinido, por lo que solo la diferencia entre los resultados de llamadas consecutivas es válida.

time.perf_counter_ns() → int¶

Similar a perf_counter(), pero el tiempo de retorno como de los nanosegundos.

time.process_time() → float¶

devuelve el valor (en fracciones de segundos) de la suma del sistema y userCPU tiempo del proceso actual. No incluye el tiempo transcurrido durante el sueño. Por definición, abarca todo el proceso. El punto de referencia del valor redondeado no está definido, por lo que solo la diferencia entre los resultados de llamadas consecutivas es válida.

time.process_time_ns() → int¶

Similar a process_time() pero el tiempo de retorno como de los nanosegundos.,

time.sleep(secs)¶

Suspender la ejecución del subproceso de llamada para el número determinado de segundos.El argumento puede ser un número de coma flotante para indicar un tiempo de sueño más preciso. El tiempo de suspensión real puede ser menor que el solicitado porque anycaught signal terminará el sleep() después de la ejecución de la rutina de captura de thatsignal. Además, el tiempo de suspensión puede ser más largo que el requerido por una cantidad arbitraria debido a la programación de otras actividades en el sistema.,

time.strftime(format)¶

Convertir una tupla o struct_time representa un momento como el que devuelvegmtime() o localtime() para una cadena especificada por el formatargument. Si no se proporciona t, se utiliza la hora actual devuelta porlocaltime(). format debe ser una cadena., ValueError israised if any field in t is outside of the allowed range.

0 es un argumento legal para cualquier posición en la tupla de tiempo; si es normalmenteillegal el valor es forzado a uno correcto.

las siguientes directivas se pueden incrustar en la cadena de formato., Se muestran sin la especificación opcional de ancho de campo y precisión, y se reemplazan por los caracteres indicados en el strftime() resultado:

notas:

1. Cuando se usa con la función strptime(), la directiva %p solo afecta al campo hora de salida si se usa la directiva %I para analizar la hora.,

2. el rango realmente es 0 to 61; value 60 is valid intimestamps representing leap seconds and value 61 is supported for razones históricas.

3. cuando se usa con la función strptime(), %U y %W solo se utilizan en cálculos cuando se especifican el día de la semana y el año.

Aquí hay un ejemplo, un formato para fechas compatible con el especificado en el estándar de correo electrónico de Internet 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'

las directivas adicionales pueden ser compatibles en ciertas plataformas, pero solo las que se enumeran aquí tienen un significado estandarizado por ANSI C. para ver el conjunto completo de códigos de formato compatibles en su plataforma, consulte la documentación de strftime(3).

en algunas plataformas, una especificación opcional de ancho de campo y precisión puede seguir inmediatamente el '%' inicial de una directiva en el siguiente orden;esto tampoco es portátil. El ancho del campo es normalmente 2 excepto para %j donde es 3.,

time.strptime(string)¶

Analizar una cadena que representa un tiempo de acuerdo a un formato. El retorno valueis un struct_time como se devuelve gmtime() olocaltime().

el parámetro format utiliza las mismas directivas que las utilizadas porstrftime() ; por defecto es "%a %b %d %H:%M:%S %Y" que coincide con el formato devuelto por ctime(). Si la cadena no se puede analizar de acuerdo con el formato, o si tiene un exceso de datos después del análisis, ValueError israised., Los valores predeterminados utilizados para rellenar los datos faltantes cuando no se pueden inferir valores más precisos son (1900, 1, 1, 0, 0, 0, 0, 1, -1).Tanto string como format deben ser strings.

Por ejemplo:

Soporte para el %Z directiva se basa en los valores contenidos en el tznamey si daylight es cierto. Debido a esto, es específico de la plataforma, excepto para reconocer UTC y GMT, que siempre se conocen (y se consideran zonas horarias que no son de horario de verano).

solo se admiten las directivas especificadas en la documentación., Debido a questrftime() se implementa por plataforma, a veces puede ofrecer más Directivas que las enumeradas. Pero strptime() es independiente de cualquier plataforma y por lo tanto no necesariamente soporta todas las directivas disponibles que no están documentadas como soportadas.

classtime.struct_time¶

El tipo del valor de tiempo de la secuencia devuelve gmtime(),localtime() y strptime(). Es un objeto con una interfaz namedtuple: se puede acceder a los valores por índice y por nombre de atributo., Los siguientes valores están presentes:

tenga en cuenta que a diferencia de la estructura C, el valor de mes es un rango de , no.

en llamadas a mktime(), tm_isdst se puede establecer en 1 cuando daylightsavings time está en vigor, y 0 cuando no lo está. Un valor de -1 indica que esto no se conoce, y por lo general dará lugar a que se rellene el estado correcto.

cuando se pasa una tupla con una longitud incorrecta a una función que espera unstruct_time, o que tiene elementos del tipo incorrecto, se eleva unTypeError.,

time.time() → float¶

Volver el tiempo en segundos desde la época como un flotante pointnumber. La fecha específica de la época y el manejo de segundos Leap depende de la plataforma.En Windows y la mayoría de los sistemas Unix, el epoch es el 1 de enero de 1970,00:00:00 (UTC) y los segundos intercalares no se cuentan para el timein segundos desde el epoch. Esto se conoce comúnmente como asUnix time.To averigüe cuál es el epoch en una plataforma dada, miregmtime(0).,

tenga en cuenta que aunque el tiempo siempre se devuelve como un número de punto flotante, no todos los sistemas proporcionan tiempo con una precisión mejor que 1 segundo.Si bien esta función normalmente devuelve valores no decrecientes, puede devolver un valor menor que una llamada anterior si el reloj del sistema se ha retrasado entre las dos llamadas.

el número devuelto por time() se puede convertir a un formato de tiempo más común (es decir, Año, Mes, Día, Hora, etc)) en UTC pasándolo agmtime() o en hora local pasándolo a la funciónlocaltime()., En ambos casos se devuelve un objetostruct_time, desde el que se puede acceder a los componentes de la fecha del calendario como atributos.

time.thread_time() → float¶

devuelve el valor (en fracciones de segundos) de la suma del sistema y userCPU tiempo del subproceso actual. No incluye el tiempo transcurrido durante el sueño. Es un hilo específico por definición. El punto de referencia del valor redondeado no está definido, por lo que solo la diferencia entre los resultados de llamadas consecutivas en el mismo subproceso es válida.,

disponibilidad: sistemas Windows, Linux, Unix compatiblesCLOCK_THREAD_CPUTIME_ID.

time.thread_time_ns() → int¶

Similar a thread_time() pero el tiempo de retorno como de los nanosegundos.

time.time_ns() → int¶

Similar a time() pero devuelve la hora como un número entero de nanosecondssince la época.

time.tzset()¶

restablecer las reglas de conversión de tiempo utilizadas por las rutinas de la biblioteca. El environmentvariable TZ especifica cómo se hace esto., También establecerá las variablestzname (desde la variable de entorno TZ), timezone (no DSTseconds al oeste de UTC), altzone (DST segundos al oeste de UTC) y daylight(a 0 si esta zona horaria no tiene reglas de horario de verano, o tononzero si hay una hora, pasado, presente o futuro cuando se aplica el horario de verano).

disponibilidad: Unix.,

El formato estándar de la etiqueta TZ variable de entorno (whitespaceadded para mayor claridad):

std offset , end]]]

Donde los componentes son:

stdydst

Tres o más caracteres alfanuméricos dando a la zona horaria de abreviaturas. Estos serán explotados en el tiempo.tzname

offset

El desplazamiento tiene la forma: ± hh]. Esto indica el valor añadido la hora local para llegar a UTC., Si está precedida por un ‘-‘, la zona horaria está al este del meridiano primero; de lo contrario, es al oeste. Si no hay compensación, se supone que la hora de verano es una hora por delante de la hora estándar.

start, end

indica cuándo cambiar al horario de verano y viceversa. El formato de inicio y fechas de finalización son uno de los procedimientos siguientes:

Jn

El día Juliano n (1 <= n <= 365). Los días bisiestos no se cuentan, por lo que en todos los años el 28 de febrero es el día 59 y el 1 de marzo es el día 60.,

n

de base cero de día Juliano (0 <= n <= 365). Se cuentan los días bisiestos, y es posible referirse al 29 de febrero.

Mm.n.d

timetiene el mismo formato que offset excepto que no se permite ningún signo principal(‘-‘ o’+’). El valor predeterminado, si no se da la hora, es 02: 00: 00.

en muchos sistemas Unix (incluyendo *BSD, Linux, Solaris y Darwin), es más conveniente usar la base de datos zoneinfo (tzfile(5)) del sistema para especificar las reglas de zona horaria., Para hacer esto, establezca el TZ environmentvariable a la ruta del archivo de datos de zona horaria requerido, en relación con la raíz de la base de datos de zona horaria del sistema ‘zoneinfo’, generalmente ubicada en/usr/share/zoneinfo. Por ejemplo, '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')