Função de biblioteca C - mktime ()
Descrição
A função da biblioteca C time_t mktime(struct tm *timeptr) converte a estrutura apontada por timeptr em um valor time_t de acordo com o fuso horário local.
Declaração
A seguir está a declaração para a função mktime ().
time_t mktime(struct tm *timeptr)
Parâmetros
timeptr- Este é o ponteiro para um valor time_t que representa um tempo do calendário, dividido em seus componentes. Abaixo está o detalhe da estrutura timeptr
struct tm {
int tm_sec; /* seconds, range 0 to 59 */
int tm_min; /* minutes, range 0 to 59 */
int tm_hour; /* hours, range 0 to 23 */
int tm_mday; /* day of the month, range 1 to 31 */
int tm_mon; /* month, range 0 to 11 */
int tm_year; /* The number of years since 1900 */
int tm_wday; /* day of the week, range 0 to 6 */
int tm_yday; /* day in the year, range 0 to 365 */
int tm_isdst; /* daylight saving time */
};
Valor de retorno
Esta função retorna um valor time_t correspondente ao tempo do calendário passado como argumento. Em caso de erro, um valor -1 é retornado.
Exemplo
O exemplo a seguir mostra o uso da função mktime ().
#include
#include
int main () { int ret; struct tm info; char buffer[80]; info.tm_year = 2001 - 1900; info.tm_mon = 7 - 1; info.tm_mday = 4; info.tm_hour = 0; info.tm_min = 0; info.tm_sec = 1; info.tm_isdst = -1; ret = mktime(&info); if( ret == -1 ) { printf("Error: unable to make time using mktime\n"); } else { strftime(buffer, sizeof(buffer), "%c", &info ); printf(buffer); } return(0); }
Vamos compilar e executar o programa acima que produzirá o seguinte resultado -
Wed Jul 4 00:00:01 2001