Funções e tipos de tempo do RenderScript
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Visão geral
As funções abaixo podem ser usadas para informar a hora atual do relógio e o horário
de atividade atual do sistema. Não é recomendado chamar essas funções dentro de um kernel.
Resumo
| Tipos |
|---|
|
rs_time_t (em inglês)
|
Segundos desde 1o de janeiro de 1970
|
|
rs_tm (link em inglês)
|
Estrutura de data e hora
|
| Funções |
|---|
|
rsGetDt (link em inglês)
|
Tempo decorrido desde a última ligação
|
|
rsLocaltime (em inglês)
|
Converter para o horário local
|
|
rsTime (link em inglês)
|
Segundos desde 1o de janeiro de 1970
|
|
rsUptimeMillis (em inglês)
|
Tempo de atividade do sistema em milissegundos
|
|
rsUptimeNanos (em inglês)
|
Tempo de atividade do sistema em nanossegundos
|
Tipos
rs_time_t
: segundos desde 1o de janeiro de 1970
Um typedef de: int Ao compilar para 32 bits.
Um typedef de: long Ao compilar para 64 bits.
Tempo do calendário interpretado como segundos decorridos desde a época (00:00:00 em 1o de janeiro de 1970, Tempo Universal Coordenado (UTC, na sigla em inglês).
rs_tm
: estrutura de data e hora
Uma estrutura com os seguintes campos:
| int tm_sec | Segundos após o minuto. Esse valor varia de 0 a 59, mas possivelmente até 60 para segundos bissextos. |
|---|
| int tm_min | Minutos após a hora. Esse valor vai de 0 a 59. |
|---|
| int tm_hour | Horas depois da meia-noite. Esse valor vai de 0 a 23. |
|---|
| int tm_mday | Dia do mês. Esse valor vai de 1 a 31. |
|---|
| int tm_mon | Meses desde janeiro. Esse valor vai de 0 a 11. |
|---|
| int tm_year | Anos desde 1900. |
|---|
| int tm_wday | Dias desde domingo. Esse valor vai de 0 a 6. |
|---|
| int tm_yday | Dias desde 1o de janeiro. Esse valor vai de 0 a 365. |
|---|
| int tm_isdst | Sinalização que indica se o horário de verão está em vigor. O valor será positivo se estiver em vigor, zero se não estiver e negativo se a informação não estiver disponível. |
|---|
Estrutura de dados para componentes de tempo detalhados.
Funções
rsGetDt
: tempo decorrido desde a última chamada
Retorna o tempo em segundos desde que essa função foi chamada pela última vez neste script.
rsLocaltime
: converter para o horário local
Parâmetros
| local | Ponteiro da estrutura temporal em que o horário local será armazenado. |
|---|
| cronômetro | Insira o tempo como um número de segundos desde 1o de janeiro de 1970. |
|---|
Returns
| Ponteiro para o horário local de saída, ou seja, o mesmo valor do parâmetro local. |
Converte o tempo especificado pelo timer em uma estrutura rs_tm que fornece ano, mês, hora etc. Esse valor é armazenado em *local.
Essa função retorna o mesmo ponteiro que é passado como primeiro argumento. Se o parâmetro local for NULL, essa função não fará nada e retornará NULL.
rsTime
: segundos desde 1o de janeiro de 1970
Parâmetros
| cronômetro | Local para também armazenar o horário retornado da agenda. |
|---|
Returns
| Segundos desde a época, -1 se houver um erro. |
Retorna o número de segundos desde a época (00:00:00 UTC, 1o de janeiro de 1970).
Se o timer não for NULL, o resultado também será armazenado na memória apontada por
essa variável.
rsUptimeMillis
: tempo de atividade do sistema em milissegundos
Returns
| Tempo de atividade em milissegundos. |
Retorna o relógio atual do sistema (tempo de atividade) em milissegundos.
rsUptimeNanos
: tempo de atividade do sistema em nanossegundos
Returns
| Tempo de atividade em nanossegundos. |
Retorna o relógio atual do sistema (tempo de atividade) em nanossegundos.
A granularidade dos valores retornados por essa chamada pode ser muito maior do que um nanossegundo.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# RenderScript Time Functions and Types\n\nOverview\n--------\n\nThe functions below can be used to tell the current clock time and the current\nsystem up time. It is not recommended to call these functions inside of a kernel.\n\nSummary\n-------\n\n| Types ||\n|--------------------------------------------------------------------------------|-------------------------------|\n| [rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t) | Seconds since January 1, 1970 |\n| [rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm) | Date and time structure |\n\n| Functions ||\n|------------------------------------------------------------------------------------------|-------------------------------|\n| [rsGetDt](/guide/topics/renderscript/reference/rs_time#android_rs:rsGetDt) | Elapsed time since last call |\n| [rsLocaltime](/guide/topics/renderscript/reference/rs_time#android_rs:rsLocaltime) | Convert to local time |\n| [rsTime](/guide/topics/renderscript/reference/rs_time#android_rs:rsTime) | Seconds since January 1, 1970 |\n| [rsUptimeMillis](/guide/topics/renderscript/reference/rs_time#android_rs:rsUptimeMillis) | System uptime in milliseconds |\n| [rsUptimeNanos](/guide/topics/renderscript/reference/rs_time#android_rs:rsUptimeNanos) | System uptime in nanoseconds |\n\nTypes\n-----\n\n#### rs_time_t\n: Seconds since January 1, 1970\n\nA typedef of: int When compiling for 32 bits.\n\nA typedef of: long When compiling for 64 bits.\n\nCalendar time interpreted as seconds elapsed since the Epoch (00:00:00 on\nJanuary 1, 1970, Coordinated Universal Time (UTC)). \n\n#### rs_tm\n: Date and time structure\n\nA structure with the following fields:\n\n| int tm_sec | Seconds after the minute. This ranges from 0 to 59, but possibly up to 60 for leap seconds. |\n| int tm_min | Minutes after the hour. This ranges from 0 to 59. |\n| int tm_hour | Hours past midnight. This ranges from 0 to 23. |\n| int tm_mday | Day of the month. This ranges from 1 to 31. |\n| int tm_mon | Months since January. This ranges from 0 to 11. |\n| int tm_year | Years since 1900. |\n| int tm_wday | Days since Sunday. This ranges from 0 to 6. |\n| int tm_yday | Days since January 1. This ranges from 0 to 365. |\n| int tm_isdst | Flag to indicate whether daylight saving time is in effect. The value is positive if it is in effect, zero if it is not, and negative if the information is not available. |\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n\n\u003cbr /\u003e\n\nData structure for broken-down time components.\n\nFunctions\n---------\n\n#### rsGetDt\n: Elapsed time since last call\n\n|------------------|---|\n| float rsGetDt(); | |\n\n##### Returns\n\n|------------------|\n| Time in seconds. |\n\nReturns the time in seconds since this function was last called in this script. \n\n#### rsLocaltime\n: Convert to local time\n\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| [rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm)\\* rsLocaltime([rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm)\\* local, const [rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t)\\* timer); | |\n\n##### Parameters\n\n| local | Pointer to time structure where the local time will be stored. |\n| timer | Input time as a number of seconds since January 1, 1970. |\n|-------|----------------------------------------------------------------|\n\n##### Returns\n\n|-------------------------------------------------------------------------------|\n| Pointer to the output local time, i.e. the same value as the parameter local. |\n\nConverts the time specified by timer into a [rs_tm](/guide/topics/renderscript/reference/rs_time#android_rs:rs_tm) structure that provides year, month,\nhour, etc. This value is stored at \\*local.\n\nThis functions returns the same pointer that is passed as first argument. If the\nlocal parameter is NULL, this function does nothing and returns NULL. \n\n#### rsTime\n: Seconds since January 1, 1970\n\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| [rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t) rsTime([rs_time_t](/guide/topics/renderscript/reference/rs_time#android_rs:rs_time_t)\\* timer); | |\n\n##### Parameters\n\n| timer | Location to also store the returned calendar time. |\n|-------|----------------------------------------------------|\n\n##### Returns\n\n|--------------------------------------------------|\n| Seconds since the Epoch, -1 if there's an error. |\n\nReturns the number of seconds since the Epoch (00:00:00 UTC, January 1, 1970).\n\nIf timer is non-NULL, the result is also stored in the memory pointed to by\nthis variable. \n\n#### rsUptimeMillis\n: System uptime in milliseconds\n\n|-----------------------------------------------------------------------------------------------------|---|\n| [int64_t](/guide/topics/renderscript/reference/rs_value_types#android_rs:int64_t) rsUptimeMillis(); | |\n\n##### Returns\n\n|-------------------------|\n| Uptime in milliseconds. |\n\nReturns the current system clock (uptime) in milliseconds. \n\n#### rsUptimeNanos\n: System uptime in nanoseconds\n\n|----------------------------------------------------------------------------------------------------|---|\n| [int64_t](/guide/topics/renderscript/reference/rs_value_types#android_rs:int64_t) rsUptimeNanos(); | |\n\n##### Returns\n\n|------------------------|\n| Uptime in nanoseconds. |\n\nReturns the current system clock (uptime) in nanoseconds.\n\nThe granularity of the values return by this call may be much larger than a nanosecond."]]
