C++ Fecha y hora

Fecha y hora (Date y Time)

La biblioteca <ctime> nos permite trabajar con fechas y horas.

Para usarlo, debes importar el archivo de encabezado <ctime>:

#include <ctime> // Importar la biblioteca ctime

Mostrar fecha y hora actuales

La biblioteca <ctime> tiene una variedad de funciones para medir fechas y horas.

La función time() nos proporciona una marca de tiempo que representa la fecha y hora actuales. Podemos usar la función ctime() para mostrar la fecha y hora que representa una marca de tiempo:

// Obtener la marca de tiempo para la fecha y hora actuales
time_t timestamp;
time(&timestamp);

// Mostrar la fecha y hora representadas por la marca de tiempo
cout << ctime(&timestamp);

time_t timestamp = time(NULL);

Tipos de datos

Hay dos tipos de datos diferentes que se utilizan para almacenar la fecha y la hora: time_t para marcas de tiempo y struct tm para estructuras de fecha y hora.

Las marcas de tiempo representan un momento en el tiempo como un único número, lo que facilita que la computadora realice cálculos.

Estructuras de fecha y hora son estructuras que representan diferentes componentes de la fecha y la hora como miembros. Esto nos facilita especificar fechas. Las estructuras de fecha y hora tienen los siguientes miembros:

• tm_sec - Los segundos dentro de un minuto
• tm_min - Los minutos dentro de una hora
• tm_hour - La hora dentro de un día (de 0 a 23)
• tm_mday - El día del mes
• tm_mon - El mes (del 0 al 11 a partir de enero)
• tm_year - El número de años desde 1900
• tm_wday - El día de la semana (de 0 a 6 a partir del domingo)
• tm_yday - El día del año (de 0 a 365, siendo 0 el 1 de enero)
• tm_isdst - Positivo cuando el horario de verano está vigente, cero cuando no está vigente y negativo cuando se desconoce

Creación de marcas de tiempo

La función time() solo puede crear una marca de tiempo para la fecha actual, pero podemos crear una marca de tiempo para cualquier fecha usando mktime() función.

La función mktime() convierte una estructura de fecha y hora en una marca de tiempo.

struct tm datetime;
time_t timestamp;

datetime.tm_year = 2023 - 1900; // Número de años desde 1900
datetime.tm_mon = 12 - 1; // Número de meses desde enero
datetime.tm_mday = 17;
datetime.tm_hour = 12;
datetime.tm_min = 30;
datetime.tm_sec = 1;
// Se debe especificar el horario de verano
// -1 usa la configuración de zona horaria de la computadora
datetime.tm_isdst = -1;

timestamp = mktime(&datetime);

cout << ctime(&timestamp);

Creando estructuras de fecha y hora

La función mktime() también completa los campos tm_wday y tm_yday miembros de la estructura de fecha y hora con los valores correctos, lo que completa la estructura y proporciona una fecha y hora válida. Se puede utilizar, por ejemplo, para encontrar el día de la semana de una fecha determinada:

// Cree la estructura de fecha y hora y use mktime para completar los miembros que faltan
struct tm datetime;
datetime.tm_year = 2023 - 1900; // Número de años desde 1900
datetime.tm_mon = 12 - 1; // Número de meses desde enero
datetime.tm_mday = 17;
datetime.tm_hour = 0; datetime.tm_min = 0; datetime.tm_sec = 0;
datetime.tm_isdst = -1;
mktime(&datetime);

string weekdays[] = {"Sunday", "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday"};

cout << "The date is on a " << weekdays[datetime.tm_wday];

Las funciones localtime() y gmtime() pueden convertir marcas de tiempo en estructuras de fecha y hora.

La función localtime() devuelve un puntero a una estructura que representa la hora en la zona horaria de la computadora.

La función gmtime() devuelve un puntero a una estructura que representa la hora en la zona horaria GMT.

Estas funciones devuelven un puntero a una estructura de fecha y hora. Si queremos asegurarnos de que su valor no cambie inesperadamente, debemos hacer una copia eliminando la referencia al puntero. Para obtener más información sobre la desreferenciación, consulte la página Desreferenciación de C++.

time_t timestamp = time(&timestamp);
struct tm datetime = *localtime(&timestamp);

cout << datetime.tm_hour;

Mostrar fechas

Hasta ahora hemos estado usando la función ctime() para mostrar la fecha contenida en una marca de tiempo. Para mostrar fechas de una estructura de fecha y hora, podemos usar la función asctime().

time_t timestamp = time(NULL);
struct tm datetime = *localtime(&timestamp);

cout << asctime(&datetime);

// Cree la estructura de fecha y hora y use mktime para corregir errores
struct tm datetime;
datetime.tm_year = 2022 - 1900; // Número de años desde 1900
datetime.tm_mon = 0; // 0 es enero
datetime.tm_mday = 32;
datetime.tm_hour = 0; datetime.tm_min = 0; datetime.tm_sec = 0;
datetime.tm_isdst = -1;
mktime(&datetime);

cout << asctime(&datetime);

Las funciones ctime() y asctime() nos permiten mostrar la fecha, pero no nos permiten para elegir cómo se muestra.

Para elegir cómo se muestra una fecha, podemos usar la función strftime().

time_t timestamp = time(NULL);
struct tm datetime = *localtime(&timestamp);

char output[50];

strftime(output, 50, "%B %e, %Y", &datetime);
cout << output << "\n";

strftime(output, 50, "%I:%M:%S %p", &datetime);
cout << output << "\n";

strftime(output, 50, "%m/%d/%y", &datetime);
cout << output << "\n";

strftime(output, 50, "%a %b %e %H:%M:%S %Y", &datetime);
cout << output << "\n";

La función strftime() formatea una fecha y la escribe como una cadena de estilo C en una matriz char. Tiene cuatro parámetros:

1. El primer parámetro apunta a la matriz de caracteres donde se escribirá la fecha formateada.
2. El segundo parámetro especifica el espacio disponible en la matriz.
3. El tercer parámetro nos permite elegir cómo se formatea la fecha usando especificadores de formato.
4. El último parámetro es un puntero a la estructura de fecha y hora que contiene la fecha que queremos mostrar.

La siguiente tabla tiene algunos especificadores de formato útiles. Para obtener una lista más completa, consulte la página de referencia de strftime().

Medir el tiempo

Hay dos funciones diferentes que se pueden utilizar para medir diferencias en el tiempo.

La función difftime() mide el número de segundos que pasaron entre dos marcas de tiempo diferentes. Esto es útil al medir diferencias horarias entre fechas.

time_t now;
time_t nextyear;
struct tm datetime;

now = time(NULL);
datetime = *localtime(&now);
datetime.tm_year = datetime.tm_year + 1;
datetime.tm_mon = 0;
datetime.tm_mday = 1;
datetime.tm_hour = 0; datetime.tm_min = 0; datetime.tm_sec = 0;
datetime.is_dst = -1;
nextyear = mktime(&datetime);

int diff = difftime(nextyear, now);

cout << diff << " segundos hasta el año que viene";

La función reloj() es útil para medir intervalos cortos de tiempo mientras el programa se está ejecutando. Es más precisa que la función difftime().

Cada llamada a la función de reloj devuelve un tipo especial de marca de tiempo medida en relojes (una unidad de tiempo que depende de cómo se implementó la biblioteca) que tiene un tipo de datos clock_t. Para medir una diferencia horaria, almacene una marca de tiempo en dos momentos diferentes y luego réstelos. La diferencia horaria se mide en relojes, pero puedes convertirla en segundos dividiéndola por la constante CLOCKS_PER_SEC.

clock_t before = clock();
int k = 0;
for(int i = 0; i < 100000; i++) {
k += i;
}
clock_t duration = clock() - before;
cout << "Duración: " << (float)duration / CLOCKS_PER_SEC << " seconds";

<ctime> Referencia completa

Para obtener una referencia completa de las funciones <ctime>, vaya a nuestra Referencia de C++ ctime.